E-commerce

Saleor Commerce

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

About Saleor Commerce

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).

What gets installed

Ready when the VPS starts

Compatible OS
Choice of Linux distributions
Application
Saleor Commerce
Tech stack
DockerPython 3.12DjangoUvicornCeleryPostgreSQL 15Valkey 8ReactNginx
Minimum RAM
2 GB (4 GB recommended)
Minimum CPU
2 vCPU
Default port
80
Access
root over SSH

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?

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.

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.

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.

Guide

Deploy Saleor Commerce on your VPS

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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

Questions about Saleor Commerce

← Back to E-commerceAll applications
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.

Embed the deploy button

Maintaining a project that uses Saleor Commerce? This button lets your readers deploy it on a VPS in one click, without reading Docker documentation.

Deploy Saleor Commerce on ServOrbit
Markdown
[![Deploy Saleor Commerce on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=saleor&utm_source=deploy-badge&utm_medium=referral&utm_campaign=saleor)
HTML
<a href="https://servorbit.com/vps-cloud?template=saleor&utm_source=deploy-badge&utm_medium=referral&utm_campaign=saleor"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Saleor Commerce on ServOrbit" height="40"></a>

The button points to a VPS order with the template preselected. The image is served from servorbit.com — nothing to host on your side.

Need help?

Browse our help center and FAQ, or reach our team — callback, WhatsApp or email.

Message us on WhatsAppopens in a new tab