Budibase

Key Features

• Visual drag-and-drop app builder with pre-built components for forms, tables, charts, and navigation
• Built-in database with CouchDB for storing application data and user information
• REST API auto-generation for all created applications with configurable endpoints
• Role-based access control with customizable user permissions and authentication
• External data source connectors for MySQL, PostgreSQL, MongoDB, REST APIs, and CSV imports
• Workflow automation engine with triggers, conditions, and actions for business process automation
• Custom JavaScript support for advanced logic and integrations beyond visual components
• Responsive design system that automatically adapts applications for mobile and desktop viewing

Common Use Cases

• 1Building customer relationship management (CRM) systems with contact tracking and sales pipeline management
• 2Creating inventory management dashboards with real-time stock levels and automated reorder alerts
• 3Developing employee onboarding portals with document management and workflow approvals
• 4Constructing project management tools with task assignment, progress tracking, and team collaboration features
• 5Designing financial reporting dashboards that aggregate data from multiple business systems
• 6Building helpdesk and ticketing systems for internal IT support and customer service teams
• 7Creating approval workflow applications for expense reports, purchase orders, and HR requests

Prerequisites

• Docker and Docker Compose installed with at least 4GB RAM available for the container
• Port 10000 available and not in use by other services on the host system
• Environment variables configured for JWT_SECRET, API_KEY, MINIO_SECRET, COUCH_PASSWORD, and REDIS_PASSWORD
• Basic understanding of web applications and database concepts for effective app building
• Familiarity with REST APIs if planning to integrate with external data sources
• Administrative access to configure user accounts and application permissions

docker-compose.yml

1services: 
2  budibase: 
3    image: budibase/budibase:latest
4    container_name: budibase
5    restart: unless-stopped
6    environment: 
7      MAIN_PORT: 10000
8      JWT_SECRET: ${JWT_SECRET}
9      INTERNAL_API_KEY: ${API_KEY}
10      MINIO_ACCESS_KEY: budibase
11      MINIO_SECRET_KEY: ${MINIO_SECRET}
12      COUCH_DB_PASSWORD: ${COUCH_PASSWORD}
13      REDIS_PASSWORD: ${REDIS_PASSWORD}
14    volumes: 
15      - budibase_data:/data
16    ports: 
17      - "10000:10000"
18
19volumes: 
20  budibase_data: 

.env Template

1JWT_SECRET=generate-jwt-secret
2API_KEY=generate-api-key
3MINIO_SECRET=generate-minio-secret
4COUCH_PASSWORD=changeme
5REDIS_PASSWORD=changeme

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  budibase:
5    image: budibase/budibase:latest
6    container_name: budibase
7    restart: unless-stopped
8    environment:
9      MAIN_PORT: 10000
10      JWT_SECRET: ${JWT_SECRET}
11      INTERNAL_API_KEY: ${API_KEY}
12      MINIO_ACCESS_KEY: budibase
13      MINIO_SECRET_KEY: ${MINIO_SECRET}
14      COUCH_DB_PASSWORD: ${COUCH_PASSWORD}
15      REDIS_PASSWORD: ${REDIS_PASSWORD}
16    volumes:
17      - budibase_data:/data
18    ports:
19      - "10000:10000"
20
21volumes:
22  budibase_data:
23EOF
24
25# 2. Create the .env file
26cat > .env << 'EOF'
27JWT_SECRET=generate-jwt-secret
28API_KEY=generate-api-key
29MINIO_SECRET=generate-minio-secret
30COUCH_PASSWORD=changeme
31REDIS_PASSWORD=changeme
32EOF
33
34# 3. Start the services
35docker compose up -d
36
37# 4. View logs
38docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/budibase/run | bash

Troubleshooting