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
ERPNext
Application2048MB+ RAM
Open-source ERP for manufacturing, distribution, and services
erpbusinessmanufacturingaccounting
Deploy ERPNext in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select ERPNext
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy ERPNext on a VPS with Server Compass
Use the ERPNext template in Server Compass to deploy a self-hosted ERP system with MariaDB and Redis services on your VPS, then verify the ERPNext web UI 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 ERPNext
Use the template picker search to find ERPNext in the Server Compass template catalog.
4
Step 4Select the ERPNext template
Choose the ERPNext template. Server Compass fills the ERPNext image, MariaDB service, persistent site volumes, database settings, and required secret value.
5
Step 5Review the ERPNext settings
Confirm the app name and compose services. In this run, the app was named erpnext-demo and used host port 8080.
6
Step 6Deploy ERPNext
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 ERPNext and MariaDB images, starts the containers, and verifies the stack.
8
Step 8Confirm ERPNext is running
After deployment finishes, return to the Apps tab and confirm the ERPNext app is marked Running with its application URL available.
9
Step 9Open ERPNext in the browser
Click Open Application or open the application URL in a browser. The ERPNext login page confirms the deployed site was initialized and is reachable.
After ERPNext Opens
- Sign in with the Administrator account and the generated ERPNext administrator password from Server Compass.
- Keep the database and administrator passwords 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 ERPNext application volume and the MariaDB data volume before storing production content.
Verified Result
The ERPNext app loaded successfully in a browser and displayed the login page.
ERPNext deployment questions
What does the ERPNext template deploy?
It deploys ERPNext with MariaDB 11.8, Redis cache, Redis queue, one-shot site initialization, and persistent site, log, and database volumes.
Which port did the tutorial use?
The tutorial used host port 8080, which maps to the ERPNext frontend on container port 8080.
Why does the browser verification stop at the login page?
A fresh ERPNext deployment is considered reachable when the initialized site loads the login page. Continuing further would require entering generated administrator credentials, so the public guide verifies the safe pre-login state.
Should this become a blog post?
No. The deployment guide should live on the ERPNext template detail page and be linked from the reusable template deployment docs page.
Self-Deploy Guide
DIY ERPNext Deployment
Learn how to self-host ERPNext with this hands-on deployment guide.
1
SSH into Your Server
Launch your preferred terminal and connect to your VPS using SSH.
terminal
# Log into your server
ssh root@<your-server-ip>
# If using key-based auth
ssh -i ~/.ssh/my-key root@<your-server-ip>First time? Docker not installed? Run: curl -fsSL https://get.docker.com | sh
2
Create Working Directory
Prepare a directory for your application files and configuration.
terminal
# Create and navigate to project directory
mkdir -p ~/apps/erpnext
cd ~/apps/erpnext3
Configure Your Containers
Create the Docker Compose configuration file with these contents:
docker-compose.yml
services:
erpnext:
image: frappe/erpnext:v15
ports:
- "8080:8000"
environment:
- MARIADB_HOST=mariadb
- REDIS_CACHE=redis-cache:6379
- REDIS_QUEUE=redis-queue:6379
- REDIS_SOCKETIO=redis-socketio:6379
volumes:
- sites:/home/frappe/frappe-bench/sites
- logs:/home/frappe/frappe-bench/logs
restart: unless-stopped
depends_on:
- mariadb
- redis-cache
- redis-queue
- redis-socketio
mariadb:
image: mariadb:10.6
environment:
- MYSQL_ROOT_PASSWORD=<your-db-root-password>
- MYSQL_DATABASE=erpnext
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
volumes:
- mariadb_data:/var/lib/mysql
restart: unless-stopped
redis-cache:
image: redis:7-alpine
restart: unless-stopped
redis-queue:
image: redis:7-alpine
restart: unless-stopped
redis-socketio:
image: redis:7-alpine
restart: unless-stopped
volumes:
sites:
logs:
mariadb_data:
Setup Variables
PORTHost port(default: 8080)DB_ROOT_PASSWORDRoot password4
Deploy with Docker Compose
Launch the application stack using Docker Compose.
terminal
# Deploy the application
docker compose up -d
# Check container health
docker compose ps
# Monitor logs
docker compose logs -f --tail=1005
Open Required Ports
Enable external access by opening the necessary port.
terminal
# Allow the application port through firewall
sudo ufw allow 8080/tcp
sudo ufw reload
# Access your app at:
# http://your-server-ip:8080Skip the Terminal
There's an easier way. Meet Server Compass.
Let Server Compass handle the complexity. Deploy ERPNext with a simple, intuitive interface.
- Intuitive dashboard
- Deploy in 3 minutes
- Free SSL included
- Blue-green deploys
- Real-time logs
- Version history
Download Server Compass$29 one-time • Lifetime license
After Deployment
After deploying ERPNext with Server Compass, complete these steps to finish setup
1
Run setup wizard
2
Configure company and modules
Need help? Check out our documentation for detailed guides.
ERPNext FAQ
Common questions about self-hosting ERPNext
How do I deploy ERPNext with Server Compass?
Simply download Server Compass, connect to your VPS, and select ERPNext 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 ERPNext?
ERPNext 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 ERPNext data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard ERPNext backup and restore procedures.
How do I update ERPNext to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest ERPNext image will be pulled and deployed with zero downtime.
Is ERPNext free to self-host?
ERPNext 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 ERPNext?
Download Server Compass and deploy ERPNext to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass