Deploy Budibase: An Optimized Solution for Building Internal Applications Within 24 Hours
A guide to deploying Budibase on NVMe Cloud VPS to build internal applications within 24 hours. The article provides setup steps, RAM and swap configuration, timeout tuning, and OOM...
Introduction to Budibase and Business Benefits
Budibase is a self-hosted platform that enables businesses to build internal applications (internal apps) without requiring deep programming expertise. With a drag-and-drop interface, users can create applications for HR management, project tracking, inventory control, or CRM systems within hours. Deploying Budibase on an NVMe Cloud VPS offers high performance, low latency, and flexible scalability, making it ideal for organizations seeking rapid, secure, and cost-effective internal app development.
In today's fast-paced business environment, companies need quick, secure, and affordable self-hosted solutions. Budibase provides an optimized approach, allowing deployment within 24 hours. This enables businesses to rapidly meet internal needs, reduce dependency on SaaS providers, and maintain full control over their data.
System Requirements and Budibase Deployment Steps on NVMe VPS
To deploy Budibase effectively on an NVMe Cloud VPS, ensure the following system requirements:
- System Requirements: VPS with at least 4GB RAM, NVMe SSD, and Linux OS (Ubuntu 22.04/24.04 or Debian 12).
- Budibase Version: Use the official release from Budibase GitHub (minimum version 1.10.0).
- Docker Version: 20.10 or later.
- Docker Compose Version: 2.20.0 or later.
Step 1: Install Docker and Docker Compose
sudo apt update
sudo apt install -y docker.io docker-compose
Step 2: Create Project Directory and Configure docker-compose.yml
mkdir budibase-project
cd budibase-project
Create a docker-compose.yml file with the following content:
version: '3.8'
services:
budibase:
image: budibase/budibase:latest
container_name: budibase
ports:
- "3000:3000"
volumes:
- ./data:/app/data
environment:
- BUBI_BASE_URL=https://your-domain.com
- [email protected]
- BUBI_ADMIN_PASSWORD=yourpassword
restart: unless-stopped
Step 3: Start the Service
docker-compose up -d
Step 4: Access and Initial Setup
After startup, access http:// to complete the initial setup. Enter the administrator email and password to create the first account.
Performance Optimization and OOM Error Troubleshooting on NVMe VPS
Since Budibase is sensitive to RAM resources, configuring RAM and swap appropriately is essential to prevent Out of Memory (OOM) errors and ensure stable performance.
1. Configure RAM and Swap
- RAM: Minimum 4GB, ideally 8GB for production environments.
- Swap: Create a 2GB swap file to improve handling of high loads.
Create the swap file:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
To retain the swap file after reboot, add it to /etc/fstab:
/swapfile none swap sw 0 0
2. Adjust Timeout Limits
In a VPS environment, setting request timeouts is necessary to prevent hanging or overloading. Adjust timeouts in docker-compose.yml:
environment:
- BUBI_API_TIMEOUT=60
- BUBI_WEB_TIMEOUT=120
3. Handle OOM Errors
- Monitor Resources: Use
htopordocker statsto track RAM usage. - Limit Container Resources: Add RAM and CPU limits in
docker-compose.yml:
resources:
limits:
memory: 4g
cpus: '2'
reservations:
memory: 2g
4. Verify and Validate
- Access the VPS URL to confirm Budibase is running.
- Create a simple application to test performance.
- Ensure no OOM errors appear in logs:
docker logs budibase.
Common Troubleshooting
| Issue | Causes | Solutions |
|---|---|---|
| Cannot access the website | Port 3000 is blocked or not open | Open port 3000 in the firewall (UFW or iptables) |
| OOM errors during startup | Insufficient RAM or no swap | Increase RAM, create a swap file, or reduce container resource limits |
| Login requests not working | Incorrect environment variables | Verify BUBI_ADMIN_EMAIL and BUBI_ADMIN_PASSWORD in docker-compose.yml |
References
High-RAM Cloud VPS Plans Optimized for AI, Databases & Cache
Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.
VPS-4E
10% VAT included
- CPU: 4 vCPU
- RAM: 8 GB
- SSD: 50 GB NVMe
