Make sure that you have set the environment variables.
There are two environment variables available for configuration:
API_URI(required): URI of the GraphQL API endpoint of a running instance of Saleor. If you are running Saleor locally with the default settings, set
APP_MOUNT_URI: URI at which the Dashboard app will be mounted. E.g. if you set
/dashboard/, your app will be mounted at
STATIC_URL: URL where the static files are located. E.g. if you use S3 bucket, you should set it to the bucket's URL. By default, Saleor assumes you serve static files from the root of your site at
You can find the instructions on how to install and run the dashboard here:
Please check if you have set the environment variables
Please check if the app is actually connected to the API
You can investigate the connection in the Network tab in your browser’s dev tools. Please look for GraphQL requests.
We’ve recently introduced a new repository: saleor-platform. You can run all Saleor components (GraphQL API, Storefront, Dashboard) from one place by using Docker. Please, bear in mind that Saleor-Platform repository has only been designed for local development.
See Extending Saleor.
You need to install
cairo and probably
pango library too.
For macOS just enter
brew install pango cairo in your terminal.
In case of Linux and Windows system follow instructions from cairo and
from pango websites.
If you get this error you probably running Seleor outside docker containers.We recommend using Saleor Platform where this error shouldn't appear.
Razorpay is currently only supported for implementation on the API. You need to separately prepare your storefront for using Razorpay.
Currently, Saleor supports the following external tax providers: Avalara (USA) and Vatlayer (European Union). If you would like to use other tax providers, you will need to create a plugin.
You can find more information here.
Firstly, please figure out what Saleor needs to know about the custom tool that you would like to use. There is a possibility of direct communication between the storefront and tool. This is the case with most content management systems.
If you need to communicate Saleor with other tools, consider writing a plugin or creating an extension.
You can check GraphQL responses in the browser dev console, on the network tab.
Saleor also supports the OpenTracing protocol allowing full in-depth analysis of all GraphQL queries. You can read more about it here: Monitoring.
In this case, please check the file permissions. They are set as private by default. It's fully up to the user which files they would like to publish.
You can find more information on the file permissions here: https://django-storages.readthedocs.io/en/latest/backends/amazon-S3.html
You can run all Saleor components from one repository only by using saleor-platform. You will need to use Docker Compose for this. Please bear in mind that saleor-platform has only been designed for local development.
There are three separate apps (three repositories): the core - GraphQL API, Dashboard, and Storefront. You can find them in the links below. In order to run all three components, please follow the instructions from the readme section of each repository:
If you would like to run Saleor locally from one repository, you can use saleor-platform.
Currently, Saleor does not support mobile payment apps such as Google Pay and Apple Pay. That feature is on our roadmap. However, we can’t yet tell when it will be available.
The old version of Saleor is available here.
Please bear in mind that we do not maintain it anymore.
We do not maintain the old version of Saleor with Django views and templates. It will not receive any new updates. If you still would like to contribute to the project, we will be happy to review your request.
To install the latest stable versions of Saleor, storefront, and dashboard, please follow the instructions from the readme sections of the following repositories:
Saleor is an open-source e-commerce platform. We provide support and guidance for our community. You can contribute by creating pull requests on GitHub. We always welcome your ideas. If you have any questions or feedback, you can also reach us on Spectrum.