All Saleor services started from a single repository
Keep in mind this repository is for local development only and is not meant to be deployed on any production environment! If you're not a developer and just want to try out Saleor you can check our live demo.
- Clone the repository:
$ git clone git@github.com:mirumee/saleor-platform.git --recursive --jobs 3
-
We are using shared folders to enable live code reloading. Without this, Docker Compose will not start:
- Windows/MacOS: Add the cloned
saleor-platformdirectory to Docker shared directories (Preferences -> Resources -> File sharing). - Windows/MacOS: Make sure that in Docker preferences you have dedicated at least 5 GB of memory (Preferences -> Resources -> Advanced).
- Linux: No action required, sharing already enabled and memory for Docker engine is not limited.
- Windows/MacOS: Add the cloned
-
Go to the cloned directory:
$ cd saleor-platform
- Build the application:
$ docker-compose build
- Apply Django migrations:
$ docker-compose run --rm web python3 manage.py migrate
- Collect static files:
$ docker-compose run --rm web python3 manage.py collectstatic --noinput
- Populate the database with example data and create the admin user:
$ docker-compose run --rm web python3 manage.py populatedb --createsuperuser
Note that --createsuperuser argument creates an admin account for admin@example.com with the password set to admin.
- Run the application:
$ docker-compose up
Both storefront and dashboard are quite big frontend projects and it might take up to few minutes for them to compile depending on your CPU. If nothing shows up on port 3000 or 9000 wait until Compiled successfully shows in the console output.
This repository will contain newest stable versions. For now it contains unstable ones - with changes made after 2.9 due to some technical requirements that allows platform to work. When new release appear, pull new version of this repository. In order to update all of them to their newest (unstable) master versions, run:
$ git submodule update --remote
You can find the latest version of Saleor, storefront and dashboard in their individual repositories:
- https://github.com/mirumee/saleor
- https://github.com/mirumee/saleor-dashboard
- https://github.com/mirumee/saleor-storefront
docker-compose up web celeryfor backend services onlydocker-compose upfor backend and frontend services
- Saleor backend - http://localhost:8000
- Saleor storefront - http://localhost:3000
- Saleor dashboard - http://localhost:9000
- Jaeger UI (OpenTracing) - http://localhost:16686
If you have any questions or feedback, do not hesitate to contact us via Spectrum or Gitter:
Disclaimer: Everything you see here is open and free to use as long as you comply with the license. There are no hidden charges. We promise to do our best to fix bugs and improve the code.
Some situations do call for extra code; we can cover exotic use cases or build you a custom e-commerce appliance.