Flowmaker SDK [beta]Docs
search
GitHub

Caddy Management (./fm caddy:*)

Caddy is the shared reverse proxy that routes traffic to all FlowMaker instances.

Commands

Rebuild Caddy Config

./fm caddy:rebuild

Regenerates the Caddy network configuration and restarts the Caddy container.

[NOTE!info/AUTO NETWORK DISCOVERY] The CLI scans all instance .env files to discover networks and generates docker-compose.infra.override.yml with all instance routes.

When to Use:

  • After creating a new instance
  • After changing instance domains
  • When Caddy routing stops working

Stop Caddy

./fm caddy:stop

Stops the Caddy container without removing data.

Delete Caddy

./fm caddy:delete

⚠️ WARNING: Stops Caddy and removes all data (CA certificates, volumes).

View Caddy Logs

./fm caddy:logs

View Caddy logs in real-time.

Export CA Certificate

./fm caddy:ca [destination]

Exports the Caddy CA certificate (default: ~/caddy-root-ca.crt).

Trust the CA on Your System:

Arch Linux:

sudo trust anchor ~/caddy-root-ca.crt

Debian/Ubuntu:

sudo cp ~/caddy-root-ca.crt /usr/local/share/ca-certificates/caddy-local.crt
sudo update-ca-certificates

macOS:

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/caddy-root-ca.crt

Firefox:

  1. Settings → Privacy & Security → Certificates → View Certificates
  2. Authorities → Import → select ~/caddy-root-ca.crt
  3. Check "Trust this CA to identify websites"

Common Workflows

First-Time Setup

./fm caddy:rebuild
./fm caddy:ca
sudo trust anchor ~/caddy-root-ca.crt
./fm create dev
./fm up dev --workers

Reset HTTPS Certificates

./fm caddy:delete
./fm caddy:rebuild
./fm caddy:ca
sudo trust anchor ~/caddy-root-ca.crt

Troubleshooting

Caddy Not Starting

ss -tlnH | grep -E ':(80|443)'
docker logs caddy-caddy-1

Routes Not Working

cat docker-compose.infra.override.yml
./fm caddy:rebuild

References