Skip to main content
Formbase ships a Docker Compose file for local dependencies: MinIO for file storage and Inbucket for email testing. The Formbase app itself runs via Bun/Node. Use this setup for local development or as a starting point for your own infrastructure.

​
Docker Compose file

This is the exact file from docker/docker-compose.yml:
docker-compose.yml
version: '3.8'

name: formbase
services:
  inbucket:
    image: inbucket/inbucket
    container_name: formbase-mailserver
    ports:
      - 9000:9000
      - 2500:2500
      - 1100:1100
    volumes:
      - formbase-mail:/data

  minio:
    image: minio/minio
    container_name: formbase-minio
    ports:
      - 9002:9002
      - 9001:9001
    volumes:
      - minio:/data
    environment:
      MINIO_ROOT_USER: ${STORAGE_ACCESS_KEY:-formbase}
      MINIO_ROOT_PASSWORD: ${STORAGE_SECRET_KEY:-password}
    entrypoint: sh
    command: -c 'mkdir -p /data/formbase && minio server /data --console-address ":9001" --address ":9002"'

volumes:
  formbase-mail:
  minio:

​
Start the services

1

Create your env file

Copy apps/web/.env.development.example to apps/web/.env.local and fill in the values.
2

Start dependencies

Run bun docker:start or docker compose -f docker/docker-compose.yml up -d from the repo root.
3

Run the app

Start the app with bun run dev (or bun run app if you only want the web app).
Inbucket’s web UI runs on http://localhost:9000 so you can inspect test emails.