Self-host Budibase on a VPS
An open-source low-code platform for building internal tools, forms, and admin panels.
levelrail-cli templates deploy budibase --name my-budibaseSpecification
- Status
- Listed
- Category
- Applications
- Services
- app-service, couchdb-service, minio-service, proxy-service, redis-service, worker-service
- Ports
- 10000
- Volumes
- 3
- Memory
- about 2 GiB
- arm64
- image published
- amd64
- not available
- Settings to fill in
- none
- License
- Copyleft license, GPL-3.0
About Budibase
An open-source low-code platform for building internal tools, forms, and admin panels. Runs 6 containers (app-service, couchdb-service, minio-service, proxy-service, redis-service, worker-service), with proxy-service listening on port 10000; data is kept in named volumes.
What it deploys
Budibase runs as 6 services in a single Compose app, listening on port 10000, with 3 named volume mounts.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| app-service | budibase.docker.scarf.sh/budibase/apps | latest | none | none |
| couchdb-service | budibase/couchdb | latest | none | budibase_couchdb_data -> /opt/couchdb/data |
| minio-service | ghcr.io/coollabsio/minio | RELEASE.2025-10-15T17-29-55Z | none | budibase_minio_data -> /data |
| proxy-service | budibase/proxy | latest | 10000 | none |
| redis-service | redis | 7-alpine | none | budibase_redis_data -> /data |
| worker-service | budibase.docker.scarf.sh/budibase/worker | latest | none | none |
Before you install
- CPU architecture. arm64 listed. Every image lists linux/arm64 in its registry manifest. That is a manifest fact, not proof the app runs on Arm.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
- Host ports. It publishes port 10000 directly on the host, so open them in the VPS firewall only if you want that.
- Review. Image is not pinned to a version tag, so a redeploy can pull different code (budibase.docker.scarf.sh/budibase/apps:latest, budibase.docker.scarf.sh/budibase/worker:latest, budibase/couchdb:latest, budibase/proxy:latest).
Settings and environment
You do not have to fill in anything. 19 secrets are generated at deploy and stored encrypted. Values are never shown here.
| Service | Variable | Value |
|---|---|---|
| app-service | API_ENCRYPTION_KEY | Generated at deploy |
| app-service | BUDIBASE_ENVIRONMENT | Preset by the template |
| app-service | COUCH_DB_URL | Generated at deploy |
| app-service | ENCRYPTION_KEY | Generated at deploy |
| app-service | INTERNAL_API_KEY | Generated at deploy |
| app-service | JWT_SECRET | Generated at deploy |
| app-service | LOG_LEVEL | Preset by the template |
| app-service | MINIO_ACCESS_KEY | Generated at deploy |
| app-service | MINIO_SECRET_KEY | Generated at deploy |
| app-service | MINIO_URL | Preset by the template |
| app-service | PORT | Preset by the template |
| app-service | REDIS_URL | Preset by the template |
| app-service | SELF_HOSTED | Preset by the template |
| app-service | WORKER_URL | Preset by the template |
| couchdb-service | COUCHDB_PASSWORD | Generated at deploy |
| couchdb-service | COUCHDB_USER | Generated at deploy |
| couchdb-service | TARGETBUILD | Preset by the template |
| minio-service | MINIO_BROWSER | Preset by the template |
| minio-service | MINIO_ROOT_PASSWORD | Generated at deploy |
| minio-service | MINIO_ROOT_USER | Generated at deploy |
| proxy-service | APPS_UPSTREAM_URL | Preset by the template |
| proxy-service | COUCHDB_UPSTREAM_URL | Preset by the template |
| proxy-service | MINIO_UPSTREAM_URL | Preset by the template |
| proxy-service | RESOLVER | Preset by the template |
| proxy-service | WORKER_UPSTREAM_URL | Preset by the template |
| worker-service | API_ENCRYPTION_KEY | Generated at deploy |
| worker-service | APPS_URL | Preset by the template |
| worker-service | CLUSTER_PORT | Preset by the template |
| worker-service | COUCH_DB_PASSWORD | Generated at deploy |
| worker-service | COUCH_DB_URL | Generated at deploy |
| worker-service | COUCH_DB_USERNAME | Generated at deploy |
| worker-service | INTERNAL_API_KEY | Generated at deploy |
| worker-service | JWT_SECRET | Generated at deploy |
| worker-service | MINIO_ACCESS_KEY | Generated at deploy |
| worker-service | MINIO_SECRET_KEY | Generated at deploy |
| worker-service | MINIO_URL | Preset by the template |
| worker-service | PORT | Preset by the template |
| worker-service | REDIS_URL | Preset by the template |
| worker-service | SELF_HOSTED | Preset by the template |
Install Budibase on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get budibase -
Deploy it
This deploys the template compose file as an app. The app name defaults to the template id; --name sets another.
levelrail-cli templates deploy budibase --name my-budibase
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Budibase.
Docs and upstream
More in Applications
- CleanuparrA companion for Sonarr, Radarr and your download client that removes stalled, failed and malicious downloads and cleans up leftovers. GPL-3.0 licensed. Open the web UI and add your arr apps and download client under Settings.
- Cockpit CMSA headless content platform for managing structured content behind a clean API, without a big CMS footprint.
- DelugeA lightweight BitTorrent client with a web interface and plugins. GPL-3.0 licensed. The web UI starts with the default password deluge, so change it on first sign in (Preferences, Interface). Only the web UI is published, so incoming peer connections are limited.
- DomoticzA home automation system with a web UI that links sensors, switches and many device protocols.
- DrupalA mature, flexible CMS for structured content, multilingual sites, and large editorial teams.
- ESPHomeA dashboard to build, flash and manage firmware for ESP32 and ESP8266 smart home devices.