# Budibase Low-Code Platform

> Budibase low-code platform for building internal tools and business applications.

- Category: Productivity & Collaboration
- Difficulty: intermediate
- Components: budibase, couchdb, minio, redis
- Tags: budibase, low-code, internal-tools, retool-alternative, automation
- Source: https://docker.recipes/productivity/budibase-low-code

## Overview

Budibase is an open-source low-code platform that enables teams to build internal tools, dashboards, and business applications without extensive coding. Founded as an alternative to expensive solutions like Retool and Microsoft PowerApps, Budibase provides a visual drag-and-drop interface for creating CRUD applications, admin panels, and workflow automation tools. The platform emphasizes speed of development while maintaining flexibility for custom integrations and complex business logic.

This Docker stack combines Budibase with CouchDB for document storage, MinIO for S3-compatible file storage, and Redis for caching and session management. CouchDB handles application metadata, user data, and configuration with its multi-master replication capabilities, while MinIO stores uploaded files, images, and static assets with high performance. Redis provides real-time caching for database queries, user sessions, and the automation engine that powers Budibase's workflow capabilities.

This configuration is ideal for organizations looking to reduce dependency on SaaS tools, maintain data sovereignty, or deploy internal applications in air-gapped environments. Startups can rapidly prototype business tools, while enterprises benefit from the self-hosted approach that keeps sensitive data within their infrastructure. The combination provides enterprise-grade storage, caching, and document management while maintaining the simplicity that makes low-code platforms valuable for non-technical users.

## Features

- Visual drag-and-drop application builder with pre-built components for forms, tables, and charts
- Built-in automation engine using Redis for triggering workflows based on database changes or external webhooks
- CouchDB multi-master replication enabling distributed deployments and offline-first mobile applications
- S3-compatible file storage through MinIO for handling user uploads, PDFs, and media assets
- Real-time collaboration features powered by Redis pub/sub for multiple users editing applications simultaneously
- External database connectivity supporting MySQL, PostgreSQL, MongoDB, and REST API integrations
- Role-based access control with Redis session management for secure multi-tenant application deployment
- Custom JavaScript scripting support for advanced business logic and CouchDB view queries

## Use cases

- Employee onboarding portals with file uploads stored in MinIO and progress tracking in CouchDB
- Inventory management systems connecting to existing ERP databases with Redis caching for performance
- Customer support dashboards aggregating data from multiple sources with real-time updates via Redis
- Approval workflow applications using Budibase automation engine and CouchDB for audit trails
- Internal reporting tools for finance teams with scheduled data refresh and MinIO for storing generated PDFs
- Field service applications leveraging CouchDB offline sync for technicians working without internet
- HR management systems with employee self-service portals and document storage in MinIO buckets

## Prerequisites

- Minimum 4GB RAM (1GB for Budibase, 1GB for CouchDB, 2GB for MinIO, 512MB for Redis)
- Port 10000 available for Budibase web interface access
- Basic understanding of environment variables for JWT secrets and database credentials
- Familiarity with CouchDB concepts like documents and views if building complex data models
- Knowledge of S3 bucket policies if configuring advanced MinIO file access controls
- Understanding of Redis memory management for production deployments with large datasets

## docker-compose.yml

```yaml
services:
  budibase:
    image: budibase/budibase:latest
    container_name: budibase
    environment:
      - SELF_HOSTED=1
      - COUCH_DB_URL=http://${COUCH_DB_USER}:${COUCH_DB_PASSWORD}@couchdb:5984
      - MINIO_URL=http://minio:9000
      - MINIO_ACCESS_KEY=${MINIO_ACCESS_KEY}
      - MINIO_SECRET_KEY=${MINIO_SECRET_KEY}
      - REDIS_URL=redis:6379
      - JWT_SECRET=${JWT_SECRET}
      - INTERNAL_API_KEY=${INTERNAL_API_KEY}
    ports:
      - "10000:80"
    depends_on:
      - couchdb
      - minio
      - redis
    networks:
      - budibase-network

  couchdb:
    image: apache/couchdb:3.3
    container_name: budibase-couchdb
    environment:
      - COUCHDB_USER=${COUCH_DB_USER}
      - COUCHDB_PASSWORD=${COUCH_DB_PASSWORD}
    volumes:
      - couchdb_data:/opt/couchdb/data
    networks:
      - budibase-network

  minio:
    image: minio/minio:latest
    container_name: budibase-minio
    command: server /data --console-address ":9001"
    environment:
      - MINIO_ROOT_USER=${MINIO_ACCESS_KEY}
      - MINIO_ROOT_PASSWORD=${MINIO_SECRET_KEY}
    volumes:
      - minio_data:/data
    networks:
      - budibase-network

  redis:
    image: redis:7-alpine
    container_name: budibase-redis
    volumes:
      - redis_data:/data
    networks:
      - budibase-network

volumes:
  couchdb_data:
  minio_data:
  redis_data:

networks:
  budibase-network:
    driver: bridge
```

## .env

```bash
# Budibase
COUCH_DB_USER=budibase
COUCH_DB_PASSWORD=budibase_password
MINIO_ACCESS_KEY=budibase
MINIO_SECRET_KEY=budibase_secret
JWT_SECRET=your-jwt-secret
INTERNAL_API_KEY=your-internal-api-key
```

## Usage notes

- Builder at http://localhost:10000
- Create account on first visit
- Drag-and-drop app builder
- Connect to external databases
- Built-in automation engine

## Troubleshooting

- Budibase shows 'Database connection failed': Verify COUCH_DB_USER and COUCH_DB_PASSWORD match CouchDB container environment variables
- File uploads fail with 'MinIO connection error': Check MINIO_ACCESS_KEY and MINIO_SECRET_KEY are identical between budibase and minio containers
- CouchDB container exits with permission errors: Ensure couchdb_data volume has proper ownership with 'chown -R 5984:5984' on the host directory
- Redis memory usage grows uncontrolled: Configure Redis maxmemory and eviction policies in production, especially for session-heavy applications
- MinIO console inaccessible: MinIO console runs on port 9001 internally but isn't exposed - add port mapping '9001:9001' if management access needed
- Budibase automation workflows timeout: Increase Redis timeout settings and check CouchDB query performance using Fauxton admin interface

