Configurations

Deploy, configure, and operate Boltbase.

Configuration Methods

Precedence order:

1. Command-line flags (highest)
2. Environment variables (BOLTBASE_ prefix)
3. Configuration file (lowest)

# Port 9000 wins
boltbase start-all --port 9000

# Despite env var
export BOLTBASE_PORT=8080

# And config file
port: 7000

Quick Start

Development

# Zero config
boltbase start-all

Production

# ~/.config/boltbase/config.yaml
host: 0.0.0.0
port: 8080

auth:
  basic:
    enabled: true
    username: admin
    password: ${ADMIN_PASSWORD}

paths:
  dags_dir: /opt/boltbase/workflows
  log_dir: /var/log/boltbase

Docker

docker run -d \
  -e BOLTBASE_HOST=0.0.0.0 \
  -e BOLTBASE_AUTH_BASIC_USERNAME=admin \
  -e BOLTBASE_AUTH_BASIC_PASSWORD=secret \
  -p 8080:8080 \
  ghcr.io/dagu-org/boltbase:latest

Topics

Server Configuration

• Host, port, authentication
• TLS/HTTPS setup
• UI customization

Base Configuration

• Shared DAG defaults
• Lifecycle handlers
• Email notifications

Operations

• Running as a service
• Monitoring and metrics
• Logging and alerting

Remote Nodes

• Configure remote instances
• Multi-node setup

Tunnel (Tailscale)

• Remote access without port forwarding
• Tailscale integration

Distributed Execution

• Coordinator and worker setup
• Service registry configuration
• Worker labels and routing

Configuration Reference

• All options
• Environment variables
• Examples

Common Configurations

Production

host: 127.0.0.1
port: 8080

tls:
  cert_file: /etc/ssl/cert.pem
  key_file: /etc/ssl/key.pem

auth:
  basic:
    enabled: true
    username: admin
    password: ${ADMIN_PASSWORD}

permissions:
  write_dags: false  # Read-only
  run_dags: true

ui:
  navbar_color: "#FF0000"
  navbar_title: "Production"

Development

host: 127.0.0.1
port: 8080
debug: true

auth:
  basic:
    enabled: false

Environment Variables

# Server
export BOLTBASE_HOST=0.0.0.0
export BOLTBASE_PORT=8080

# Paths
export BOLTBASE_DAGS_DIR=/opt/workflows
export BOLTBASE_LOG_DIR=/var/log/boltbase

# Auth
export BOLTBASE_AUTH_BASIC_USERNAME=admin
export BOLTBASE_AUTH_BASIC_PASSWORD=secret

boltbase start-all

See Also

• Set up authentication for production
• Configure base defaults for shared DAG settings
• Configure monitoring for visibility
• Set up distributed execution for scaling
• Review all options for fine-tuning