# Deploy Saleor with Easypanel

URL: /templates/saleor

Saleor is a headless, GraphQL-first open-source e-commerce platform. It separates the storefront from the backend entirely, giving you a full product, order, and customer API plus an admin Dashboard, so you can build any frontend on top of it.

## Installation notes

Point both the API Domain and Dashboard Domain below at this project before
deploying. After the first deploy, open the API domain's `/graphql/`
endpoint to confirm it responds, then open the Dashboard domain and create
the first superuser account by running
`python3 manage.py createsuperuser` in the API service's console (under the
service's Terminal tab in Easypanel). The API service runs the database
migrations each time it starts, and the worker waits until they are done.


## Benefits

### Headless and API-first

A GraphQL API decoupled from any storefront, so you can build any frontend on top of it.

### Multi-channel and multi-currency

Sell across channels, currencies, and warehouses from a single instance.

### Open source

Free and self-hostable under a BSD-3-Clause license, with no vendor lock-in.

## Features

### Admin dashboard

A full-featured React admin UI for products, orders, and customers.

### Async task processing

A dedicated Celery worker handles background jobs like emails and webhooks.

### Product and order management

Variants, attributes, collections, discounts, and complete order workflows.

### Plugin and app framework

Extend checkout, payments, and shipping through webhooks and apps.

## Configuration

- `appServiceName` (App Service Name, required): saleor

- `apiDomain` (API Domain, required): Set during installation — The domain the GraphQL API will be reachable at (no https://)

- `dashboardDomain` (Dashboard Domain, required): Set during installation — The domain the admin Dashboard will be reachable at (no https://)

- `apiServiceImage` (API/Worker Service Image, required): ghcr.io/saleor/saleor:3.23

- `dashboardServiceImage` (Dashboard Service Image, required): ghcr.io/saleor/saleor-dashboard:3.23

- `dbServiceImage` (Database Service Image, required): postgres:15-alpine

- `cacheServiceImage` (Cache Service Image, required): valkey/valkey:8.1-alpine

## Services

- saleor-api: app (ghcr.io/saleor/saleor:3.23)

- saleor-worker: app (ghcr.io/saleor/saleor:3.23)

- saleor-dashboard: app (ghcr.io/saleor/saleor-dashboard:3.23)

- saleor-db: postgres

- saleor-cache: redis

## Resources

- [Website](https://saleor.io)

- [GitHub](https://github.com/saleor/saleor)

- [Documentation](https://docs.saleor.io)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/saleor)