Installing using Docker

✋ CAUTION

This Docker image is only for Strapi v3. For now, Strapi will not update the image for v4. However, to build an image compatible with Strapi v4, we recommend following this guide (opens new window) by Simen Daehlin, Community Star at Strapi.

If you would like an official v4 image, please share it on the roadmap (opens new window).

The following documentation will guide you through the installation of a new Strapi project using Docker (opens new window).

Docker is an open platform that allows to develop, ship and run applications by using containers (i.e. packages containing all the parts an application needs to function, such as libraries and dependencies).

✏️ NOTE

You can find the official Docker image for Strapi in the Docker Hub (opens new window).

Creating a Strapi project

1. Create an empty folder.

2. In your empty folder, create a docker-compose.yaml file. It is where the new Strapi project will be created, and it defines the database and Strapi service to use.

   version: '3'
   services:
     strapi:
       image: strapi/strapi
       volumes:
         - ./app:/srv/app
       ports:
         - '1337:1337'
   

   version: '3'
   services:
     strapi:
       image: strapi/strapi
       environment:
         DATABASE_CLIENT: postgres
         DATABASE_NAME: strapi
         DATABASE_HOST: postgres
         DATABASE_PORT: 5432
         DATABASE_USERNAME: strapi
         DATABASE_PASSWORD: strapi
       volumes:
         - ./app:/srv/app
       ports:
         - '1337:1337'
       depends_on:
         - postgres
   
     postgres:
       image: postgres
       environment:
         POSTGRES_DB: strapi
         POSTGRES_USER: strapi
         POSTGRES_PASSWORD: strapi
       volumes:
         - ./data:/var/lib/postgresql/data
   

   version: '3'
   services:
     strapi:
       image: strapi/strapi
       environment:
         DATABASE_CLIENT: mysql
         DATABASE_HOST: mysql
         DATABASE_PORT: 3306
         DATABASE_NAME: strapi
         DATABASE_USERNAME: strapi
         DATABASE_PASSWORD: strapi
         DATABASE_SSL: 'false'
       volumes:
         - ./app:/srv/app
       ports:
         - '1337:1337'
       depends_on:
         - mysql
   
     mysql:
       image: mysql
       command: mysqld --default-authentication-plugin=mysql_native_password
       volumes:
         - ./data:/var/lib/mysql
       environment:
         MYSQL_ROOT_PASSWORD: strapi
         MYSQL_DATABASE: strapi
         MYSQL_USER: strapi
         MYSQL_PASSWORD: strapi
   

   version: '3'
   services:
     strapi:
       image: strapi/strapi
       environment:
         DATABASE_CLIENT: mysql
         DATABASE_HOST: mariadb
         DATABASE_PORT: 3306
         DATABASE_NAME: strapi
         DATABASE_USERNAME: strapi
         DATABASE_PASSWORD: strapi
         DATABASE_SSL: 'false'
       volumes:
         - ./app:/srv/app
       ports:
         - '1337:1337'
       depends_on:
         - mariadb
   
     mariadb:
       image: mariadb
       volumes:
         - ./data:/var/lib/mysql
       environment:
         MYSQL_ROOT_PASSWORD: strapi
         MYSQL_DATABASE: strapi
         MYSQL_USER: strapi
         MYSQL_PASSWORD: strapi
   

3. Pull the latest images using the following command:

   docker-compose pull
   

Running Strapi

To run your Strapi project created with Docker, use one of the following commands:

# Execute Docker image detaching the terminal
docker-compose up -d

# Execute Docker image without detaching the terminal
docker-compose up