If you prefer using containers or have problems with configuring PostgreSQL, Redis and Elasticsearch, try Docker instructions.
Before you are ready to run Saleor you will need certain software installed on your computer.
Python version 3.5.x or 2.7.x
pip if you’re using an older release of Python 2.7
wheelPython package if you’re using pip older than 8.1.2
Node.js version 6 or above
Debian and Ubuntu users who install Node.js using system packages will also need to install the
webpack module bundler installed globally with:
$ npm i webpack -g
Yarn installed globally with:
$ npm i yarn -g
PostgreSQL version 9.4 or above
We also strongly recommend creating a virtual environment before proceeding with installation.
Clone the repository (or use your own fork):
$ git clone https://github.com/mirumee/saleor.git
Enter the directory:
$ cd saleor/
Install all dependencies:
$ pip install -r requirements.txt
Secret key should be a unique string only your team knows. It’s serious as this key is used to ensure security of your installation. Consult Django’s documentation for details.
We try to provide usable default values for all of the settings. We’ve decided not to provide a default for
SECRET_KEYas we fear someone would inevitably ship a project with the default value left in code.
$ export SECRET_KEY='<mysecretkey>'
Create PostgreSQL user:
You need to create the user to use within your project. Username and password are extracted from
DATABASE_URLenvironmental variable. If absent, defaults to
saleor. Consult PostgreSQL’s documentation for details.
Prepare the database:
$ python manage.py migrate
Install front-end dependencies:
If this step fails go back and make sure you’re using new enough version of Node.js.
Prepare front-end assets:
$ yarn run build-assets
Run like a normal django project:
$ python manage.py runserver
If you’d like some data to test your new storefront you can populate the database with example products and orders:
$ python manage.py populatedb