Skip to main content

Docker Images

If you choose to self-host, Docker is Saleor's preferred method of deployment.

Saleor Core​

Saleor publishes official Docker images for all Core releases. The images can be found on GitHub Container Registry.

Using the official image​

To pull the image from GitHub Container Registry, use the following command, substituting the desired version for <version>:

docker pull ghcr.io/saleor/saleor:<version>

To use it in your project, refer to the official image in your docker-compose.yml file:

version: "3.4"

services:
  # ...
  saleor:
    image: ghcr.io/saleor/saleor:<version>
    # ...

Building from scratch​

If you want to build the image yourself, use docker build in the saleor directory:

cd saleor
docker build -t <yourimagename> .

The image is suitable for production use. See the Configuration for a list of environment variables you can use to configure the container.

Saleor Dashboard​

Saleor publishes official Docker images for all Dashboard releases. The images can be found on GitHub Container Registry.

Dashboard versioning follows the same pattern as the Core. Minor versions of the Dashboard are compatible with the same minor version of the Core. For example, Dashboard version 3.20 is compatible with Core version 3.20.

Using the official image​

To pull the image from GitHub Container Registry, use the following command, substituting the desired version for <version>:

docker pull ghcr.io/saleor/saleor-dashboard:<version>

To use it in your project, refer to the official image in your docker-compose.yml file:

version: "3.4"

services:
  # ...
  dashboard:
    image: ghcr.io/saleor/saleor-dashboard:<version>
    # ...

Dashboard uses http://localhost:8000 as the default API address. You can change it by setting the corresponding environment variable:

version: "3.4"

services:
  # ...
  dashboard:
    image: ghcr.io/saleor/saleor-dashboard:<version>
    # ...
    environment:
      - API_URL=http://your-own-api-address.com/graphql/

Building from scratch​

If you want to build the image yourself, use docker build in the saleor-dashboard directory:

cd saleor-dashboard
docker build -t <yourimagename> .

The image is suitable for production use however the Dashboard is a static application and does not require a backend server.

We recommend using a dedicated static hosting platform like Amazon S3 and CloudFront, or Vercel, instead of Docker.