Build and run an online store.

Saleor Commerce

Headless API-first e-commerce — Python/Django, GraphQL, React admin dashboard. BSD-3, 23 k⭐ GitHub.

2 GB (4 GB recommended) RAM 2 vCPU Port 80 In validation

In validation

Automatic installation for this solution is ready and currently going through our tests on a real server. Ordering will open as soon as validation is complete.

Tech stack

DockerPython 3.12DjangoUvicornCeleryPostgreSQL 15Valkey 8ReactNginx
Minimum RAM2 GB (4 GB recommended)
Minimum CPU2 vCPU
Default port80
Compatible OSChoice of Linux distributions

Saleor Commerce (BSD-3-Clause, 23 k+ GitHub stars) is a headless e-commerce platform built with Python and Django. Unlike traditional e-commerce platforms such as WooCommerce or PrestaShop, Saleor exposes everything through a single GraphQL API — products, orders, customers, payments, shipping — giving developers complete freedom to build any storefront they want, from a Next.js storefront to a React Native mobile app.

On your ServOrbit VPS, Saleor runs as five Docker containers: the Django API (served by Uvicorn), a Celery worker for background tasks, the React admin dashboard, PostgreSQL 15 for data, and Valkey for caching and the task queue. A Nginx proxy routes all traffic from a single domain. First boot generates the RSA key for JWT signing and runs database migrations automatically.

The admin dashboard gives you full control over products, variants, attributes, collections, pricing rules, promotions, orders, fulfillment, customers and reports — everything you need to run a store without writing code. The GraphQL API powers your storefront and any third-party integrations (Zapier, n8n, mobile apps).

Key features

Full GraphQL and REST API covering products, orders, customers and payments
React admin dashboard for catalog, pricing, orders and customer management
Multi-channel architecture: separate storefronts with independent pricing and availability
Product variants, attributes, collections and custom metadata
Built-in promotion engine: vouchers, discounts, flash sales
Fulfillment workflow with warehouse, tracking and return management
Celery background worker for webhooks, email and async tasks
BSL-3 licence — no per-transaction fee, no vendor lock-in

When to use this solution?

1

Headless storefront with Next.js or React Native

Use Saleor as a backend API and build your storefront exactly as you want — a Next.js site, a mobile app, or both. The GraphQL API gives you everything: products, cart, checkout, payments.

2

B2B catalog with complex pricing

Multi-channel lets you serve different customer segments with separate pricing lists, currencies and product availability from a single admin dashboard.

3

Developer-owned e-commerce backend

Integrate Saleor with n8n, Activepieces or any webhook consumer. Every event (order placed, payment captured, inventory update) fires a configurable webhook to your automation stack.

Deploy Saleor Commerce on your VPS

Guide optimized for ServOrbit Cloud VPS.

01

Order a ServOrbit VPS (2 GB RAM minimum)

The full stack — API, Celery worker, PostgreSQL, Valkey and the admin dashboard — needs at least 2 GB RAM. 4 GB gives PostgreSQL room to breathe under concurrent requests and lets the Celery worker run without memory pressure.

02

Attach your domain

Saleor anchors the admin dashboard API URL and Django's ALLOWED_CLIENT_HOSTS to your domain at first boot — it cannot be changed after the stack starts without recreating volumes. Attach your domain before deploying.

03

Admin credentials

The init container creates the superuser account [email protected] with the password shown in your ServOrbit client area. Log in at https://<your-domain>/ immediately after deployment.

04

Create a channel

Saleor requires at least one channel before you can create products. Go to Catalogue → Channels → Create channel, set a name (e.g. "Default"), a currency and a country. The default channel slug "default-channel" is already configured.

05

Deploy the stack from the Marketplace

In your ServOrbit dashboard: Marketplace → E-commerce → Saleor → Deploy. Five containers start: PostgreSQL 15, Valkey, the Saleor API, the Celery worker and the React admin dashboard. First boot takes 90–120 seconds.

06

Build your storefront

The admin dashboard manages your catalog and orders. For the customer-facing store, deploy a Saleor-compatible Next.js storefront pointing to https://<your-domain>/graphql/ — or build your own using the GraphQL API.

07

Connect your payment gateway

Install a Saleor App from the Apps section of the dashboard: Stripe, Adyen, PayPal or a custom gateway via the Saleor App SDK. Each gateway is a small service that connects to the Saleor webhook API.

Frequently asked questions

Saleor Commerce is an open-source headless e-commerce platform built with Python and Django. It exposes a full GraphQL API for products, orders, customers and payments, plus a React admin dashboard for store management. It is licensed under BSD-3-Clause and has over 23 000 GitHub stars.

Build and run an online store.

Saleor Commerce isn't orderable yet.

Automatic installation for this solution is ready and currently going through our tests on a real server. Ordering will open as soon as validation is complete.

Need help?

Browse our help center and FAQ, or reach our team — callback, WhatsApp or email. Support in French, English and Arabic.

Message us on WhatsAppopens in a new tab