Installing NocoBase on a VPS with Docker for Non-IT People — A Step-by-Step Guide with Screenshots
by BAMFLOW • • 4 min read
Install NocoBase on a VPS with Docker: a step-by-step guide for non-IT people, with domain, HTTPS and automatic backups in about 30 minutes.
Installing NocoBase on a VPS with Docker for Non-IT People — A Step-by-Step Guide with Screenshots
Quick summary: You do not need to be an IT specialist to install NocoBase. With the NocoBase Docker method, you only need a common VPS, a domain name and about 30 minutes: install Docker, run one configuration file, attach your domain, enable HTTPS, create the first admin account and turn on automatic backups. New to the platform? Read What is NocoBase? first.
1. What self-hosting means — your company's filing cabinet
Think of your company data — customers, orders, receipts, payroll — as paper files. Renting SaaS is like renting a storage room in someone else's building: the landlord holds the keys. Self-hosting means buying your own filing cabinet for your own room. The cabinet is a VPS — an always-on computer in a data centre that you rent privately. You hold the keys and pay no per-user fee. The trade-off is responsibility: your cabinet, your locks, your backups.
Docker is the pre-packed box: NocoBase and everything it needs, in matching versions — place it on the VPS and open it. This is BAMFLOW's standard setup for client projects. BAMFLOW is the official NocoBase partner in Vietnam, with 300+ applications delivered, 150+ business customers and 1000+ learners trained.
2. What to prepare: a minimum VPS, a domain, 30 minutes
First, a VPS — a common plan is enough: 2+ CPU cores, 4 GB RAM, 40 GB SSD, Ubuntu 22.04 or 24.04 LTS, typically a few hundred thousand dong per month. The provider sends you the IP, the admin account (usually root) and a password — store them safely.
Second, a domain name such as app.yourcompany.com — a free subdomain is enough — plus about 30 minutes and a command-line window (Terminal on Mac, PowerShell on Windows).
A note on versions: NocoBase is updated often — if anything differs in your version, check the official NocoBase documentation (docs.nocobase.com).
3. Install Docker + install NocoBase, command by command
Step 1 — Log in to the VPS (replace the sample IP; type yes, then the password — nothing shows while typing):
ssh root@123.123.123.123
Step 2 — Install Docker with Docker's official script, then verify:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
docker --version
docker compose version
Step 3 — Create docker-compose.yml. Docker Compose starts the whole system from this one file: NocoBase (official nocobase/nocobase image) plus PostgreSQL. Port 13000 is the default; uploads live in ./storage, mapped to /app/nocobase/storage:
mkdir -p /opt/nocobase
cd /opt/nocobase
nano docker-compose.yml
services:
nocobase:
image: nocobase/nocobase:latest
container_name: nocobase
restart: always
environment:
APP_KEY: 'replace-with-a-long-random-secret'
DB_DIALECT: postgres
DB_HOST: db
DB_PORT: 5432
DB_DATABASE: nocobase
DB_USER: nocobase
DB_PASSWORD: 'replace-with-a-strong-database-password'
TZ: Asia/Ho_Chi_Minh
ports:
- '13000:13000'
volumes:
- ./storage:/app/nocobase/storage
depends_on:
- db
db:
image: postgres:16
container_name: nocobase-db
restart: always
environment:
POSTGRES_DB: nocobase
POSTGRES_USER: nocobase
POSTGRES_PASSWORD: 'replace-with-a-strong-database-password'
volumes:
- ./db-data:/var/lib/postgresql/data
Set two values yourself: APP_KEY, a long random secret, and DB_PASSWORD, identical in both places — one character different and NocoBase cannot reach its database. Save: Ctrl + O, Enter; exit: Ctrl + X.
Step 4 — Start the system (the first start downloads the images, a few minutes):
docker compose up -d
docker compose ps
Step 5 — Open NocoBase at http://your-vps-ip:13000. If it does not load, open port 13000 in the provider firewall. This screen means success:
4. Attach a domain + HTTPS + create the first admin account
Point the domain to the VPS: create an A record for your subdomain with the VPS IP as its value.
Add a reverse proxy and HTTPS: Nginx receives visitors on ports 80/443 and passes them to port 13000. Install Nginx and the free Let's Encrypt tooling, add a server block with proxy_pass http://127.0.0.1:13000;, test with sudo nginx -t, then issue the certificate:
sudo apt install -y nginx certbot python3-certbot-nginx
sudo certbot --nginx -d app.yourcompany.com
Create the first admin account in the initial setup, with a strong, unique password — the master key to the whole cabinet:
5. Do these right after installing: change passwords, enable automatic backups
First, review every password. Change every temporary password, including the VPS root password the provider emailed you, and create a second admin account.
Second, turn on daily automatic backups. Data lives in the database and the storage folder — a real backup covers both. Schedule these nightly (e.g. with cron):
docker exec nocobase-db pg_dump -U nocobase nocobase > backup-db-$(date +%F).sql
tar -czf backup-storage-$(date +%F).tar.gz /opt/nocobase/storage
Copy the files somewhere outside the VPS — a backup on the same machine disappears with the original if it fails. See also BAMFLOW's guide to common self-hosting mistakes.
Third, close what you do not need: keep only ports in use (administration, 80, 443) open, and upgrade only after a fresh backup.
Prefer not to do this yourself? BAMFLOW offers an installation & handover service — NocoBase on your VPS with domain, HTTPS and backups. Message BAMFLOW via bamflow.vn.
About BAMFLOW — BAMFLOW is the official NocoBase partner in Vietnam — AppSheet, NocoBase and AI implementation and training (300+ applications, 150+ customers, 1000+ learners).
- Want to build it yourself? Register for the NocoBase AI Builder course (12 sessions) — build a real system on your own data.
- Want it deployed fast? Message BAMFLOW via bamflow.vn.