← All posts

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.

cover-final

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:

Install NocoBase — the NocoBase interface right after installation with Docker
Install NocoBase — the NocoBase interface right after installation with Docker

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:

Install NocoBase result — sample dashboard after the first login on a VPS
Install NocoBase result — sample dashboard after the first login on a VPS

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

Đọc bản tiếng Việt RSS