1
Step 1Open the server Apps tab
Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.
Back to all templates
Saleor
Application2048MB+ RAM
GraphQL-first headless e-commerce platform
ecommerceheadlessgraphqlpython
Deploy Saleor in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select Saleor
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy Saleor on a VPS with Server Compass
Use the Saleor template in Server Compass to deploy a self-hosted GraphQL-first e-commerce backend with PostgreSQL and Redis on your VPS, then verify the Saleor GraphQL endpoint in a browser.
About 7 minutesBrowser verified
2
Step 2Choose an app template
Click New App and choose the template deployment path so Server Compass can load the built-in catalog.
3
Step 3Search for Saleor
Use the template picker search to find Saleor in the Server Compass template catalog.
4
Step 4Select the Saleor template
Choose the Saleor template. Server Compass fills the Saleor image, PostgreSQL service, Redis service, persistent storage, database settings, and required secret values.
5
Step 5Review the Saleor settings
Confirm the app name and compose services. In this run, the app was named saleor-demo and used host port 8000.
6
Step 6Deploy Saleor
Review the generated environment values, keep the database password masked, confirm the port is available, and click Deploy Now.
7
Step 7Watch the deployment progress
Keep the deployment modal open while Server Compass uploads the compose file, pulls the Saleor and PostgreSQL images, starts the containers, and verifies the stack.
8
Step 8Confirm Saleor is running
After deployment finishes, return to the Apps tab and confirm the Saleor app is marked Running with its application URL available.
9
Step 9Open Saleor in the browser
Open the application health endpoint in a browser. The Saleor response confirms the deployed backend is reachable.
After Saleor Opens
- Create the first Saleor admin user before production use.
- Keep the database password masked in screenshots and docs.
- Add a domain and HTTPS before inviting users or publishing content publicly.
- Create roles and permissions before publishing editorial workflows.
- Back up both the Saleor application volume and the PostgreSQL data volume before storing production content.
Verified Result
The Saleor backend loaded successfully in a browser and returned its health response.
Saleor deployment questions
What does the Saleor template deploy?
It deploys Saleor with PostgreSQL 16, Redis, and persistent local storage and database volumes.
Which port did the tutorial use?
The tutorial used host port 8000, which maps to the Saleor web server on container port 8000.
Why does the browser verification stop at the install wizard?
Saleor is a headless backend, so the guide verifies the safe health endpoint instead of creating admin/storefront data.
Should this become a blog post?
No. The deployment guide should live on the Saleor template detail page and be linked from the reusable template deployment docs page.
Do It Yourself
Deploy Saleor via Command Line
Prefer the command line? Follow this step-by-step guide to deploy Saleor manually on your VPS.
1
Open a Terminal Connection
Start by opening a terminal window and connecting to your VPS via SSH.
terminal
# Connect to your VPS
ssh root@your-server-ip
# Or with a specific SSH key
ssh -i ~/.ssh/your-key root@your-server-ipFirst time? Docker required! Install it with: curl -fsSL https://get.docker.com | sh
2
Create Application Directory
Create a dedicated space for your application deployment.
terminal
# Create and navigate to project directory
mkdir -p ~/apps/saleor
cd ~/apps/saleor3
Create Deployment Configuration
Create a docker-compose.yml file with the following configuration:
docker-compose.yml
services:
saleor:
image: ghcr.io/saleor/saleor:latest
ports:
- "8000:8000"
environment:
- DATABASE_URL=postgres://saleor:<your-db-password>@db:5432/saleor
- REDIS_URL=redis://redis:6379
- SECRET_KEY=<your-secret-key>
- ALLOWED_HOSTS=*
restart: unless-stopped
depends_on:
- db
- redis
db:
image: postgres:16-alpine
environment:
- POSTGRES_USER=saleor
- POSTGRES_PASSWORD=<your-db-password>
- POSTGRES_DB=saleor
volumes:
- postgres_data:/var/lib/postgresql/data
restart: unless-stopped
redis:
image: redis:7-alpine
restart: unless-stopped
volumes:
postgres_data:
Configuration Variables
PORTHost port(default: 8000)SECRET_KEYSecret keyDB_PASSWORDDB password4
Launch Your Application
Deploy the stack and monitor the startup process.
terminal
# Spin up containers
docker compose up -d
# Verify deployment
docker compose ps
# Check logs for errors
docker compose logs -f5
Enable External Access
Set up firewall rules to permit incoming connections.
terminal
# Allow the application port through firewall
sudo ufw allow 8000/tcp
sudo ufw reload
# Access your app at:
# http://your-server-ip:8000Skip the Terminal
Skip the command line. Deploy visually.
Deploy Saleor with a beautiful UI instead. No SSH, no YAML editing, no terminal commands. Just click, configure, and deploy in under 3 minutes.
- Visual config editor
- Instant deployment
- Automatic HTTPS
- Smooth updates
- Live monitoring
- Quick rollbacks
Download Server Compass$29 one-time • Lifetime license
After Deployment
After deploying Saleor with Server Compass, complete these steps to finish setup
1
Run migrations
2
Create superuser
3
Deploy dashboard and storefront
Need help? Check out our documentation for detailed guides.
Saleor FAQ
Common questions about self-hosting Saleor
How do I deploy Saleor with Server Compass?
Simply download Server Compass, connect to your VPS, and select Saleor from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for Saleor?
Saleor requires a minimum of 2048MB RAM. We recommend a VPS with at least 4096MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing Saleor data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Saleor backup and restore procedures.
How do I update Saleor to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Saleor image will be pulled and deployed with zero downtime.
Is Saleor free to self-host?
Saleor is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Ready to Self-Host Saleor?
Download Server Compass and deploy Saleor to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass