> Documentation index: [Saleor](/llms.txt) · [This section](/quickstart/llms.txt)
> Source: https://docs.saleor.io/quickstart/running-locally

# Running Locally

Saleor is a 12-factor application that is configured using environment variables. We recommend using Docker because it takes care of all necessary dependencies.

1

<a id="install-docker"></a>

### Install Docker

Install [Docker Desktop](https://www.docker.com/products/docker-desktop) and [Docker Compose](https://docs.docker.com/compose/install/).

Note: To install Docker Desktop on Windows Home, follow the [instructions](https://docs.docker.com/docker-for-windows/install-windows-home/).

2

<a id="clone-repository"></a>

### Clone repository

Build Docker images by cloning the repository and running the following commands:

```bash
git clone https://github.com/saleor/saleor-platform.git
cd saleor-platform
docker compose build
```

3

<a id="apply-migrations"></a>

### Apply migrations

These commands would update the database schema to the latest version.

```bash
docker compose run --rm api python3 manage.py migrate
```

4

<a id="add-sample-data"></a>

### Add sample data

Optionally, populate the database with sample data:

```bash
docker compose run --rm api python3 manage.py populatedb
```

5

<a id="create-admin-account"></a>

### Create admin account

Follow the prompt to add admin user name and password.

```bash
docker compose run --rm api python3 manage.py createsuperuser
```

6

<a id="running-the-services"></a>

### Running the services

Run all Saleor containers (from within the `saleor-platform` directory):

The dashboard will now be available at `localhost:9000`

```bash
docker compose up
```

7

<a id="optional-add-live-reloading"></a>

### Optional: Add live reloading

This step is optional for those who want to contribute to Saleor.

Saleor uses shared folders to enable live code reloading. If you're using **Windows** or **MacOS** you will need to:

-   Add the cloned `saleor-platform` directory to the list of shared directories in Docker (_Settings_ -> _Shared Drives_ or _Preferences_ -> _Resources_ -> _File sharing_).
-   Make sure that in Docker preferences, you have dedicated at least 5 GB of memory (_Settings_ -> _Advanced_ or _Preferences_ -> _Resources_ -> _Advanced_).
