Skip to content

2.3.52 Satellite Windmill

Jump to bottom
av edited this page Apr 11, 2026 · 3 revisions

Windmill

Handle: windmill
URL: http://localhost:34521

windmill screenshot

Windmill is an open-source developer platform for building internal tools through APIs, background jobs, workflows, and UIs. It's a self-hostable alternative to Retool, Pipedream, and Superblocks.

Key Features:

  • Multi-language support: Python, TypeScript, Go, Bash, SQL, GraphQL
  • Auto-generated UIs: Scripts automatically generate interactive frontends
  • Flow composition: Chain scripts together into complex workflows
  • Custom UIs: Build sophisticated applications with low-code builder
  • Scheduling: Trigger workflows via cron schedules or webhooks
  • Enterprise-grade: Rust backend, Svelte frontend, Postgres database

Starting

# Pull the images
harbor pull windmill

# Start Windmill
harbor up windmill --open
  • On the first start, you'll need to go through initial setup:
    • Default credentials: admin@windmill.dev / changeme
    • Telemetry is opt-out, ensure to disable if sharing stats is not desired
  • There are some excellent tutorials in the official documentation: https://www.windmill.dev/docs/intro
  • There's a hub with ready-made scripts, flows and apps: https://hub.windmill.dev/

Configuration

Environment Variables

Following options can be set via harbor config:

# Main UI port (Caddy reverse proxy)
HARBOR_WINDMILL_HOST_PORT          34521

# PostgreSQL database port (optional, for debugging)
HARBOR_WINDMILL_DB_HOST_PORT       34522

# Workspace directory for persistent data
HARBOR_WINDMILL_WORKSPACE          ./services/windmill

# Windmill server/worker image
HARBOR_WINDMILL_IMAGE              ghcr.io/windmill-labs/windmill
HARBOR_WINDMILL_VERSION            latest

# Database configuration
HARBOR_WINDMILL_DB_IMAGE           postgres
HARBOR_WINDMILL_DB_VERSION         16
HARBOR_WINDMILL_DB_USER            postgres
HARBOR_WINDMILL_DB_PASSWORD        changeme
HARBOR_WINDMILL_DB_NAME            windmill

# Caddy reverse proxy
HARBOR_WINDMILL_CADDY_IMAGE        ghcr.io/windmill-labs/caddy-l4
HARBOR_WINDMILL_CADDY_VERSION      latest
HARBOR_WINDMILL_BASE_URL           :80
HARBOR_WINDMILL_ADDRESS            0.0.0.0

# Language Server Protocol
HARBOR_WINDMILL_LSP_IMAGE          ghcr.io/windmill-labs/windmill-lsp
HARBOR_WINDMILL_LSP_VERSION        latest
Volumes

Windmill persists data in the following directories:

  • services/windmill/db/ - PostgreSQL database
  • services/windmill/cache/ - Worker dependency cache
  • services/windmill/logs/ - Worker logs
  • services/windmill/lsp_cache/ - Language server cache
  • services/windmill/caddy_data/ - Caddy configuration and certificates
Caddyfile

The Caddy reverse proxy configuration is in services/windmill/Caddyfile. It routes:

  • /ws/* → Language Server (websockets)
  • /* → Windmill Server (main UI/API)
  • Port 25 → SMTP server (port 2525 on windmill-server)

Integration with Harbor

Windmill can integrate with other Harbor services:

  • Use Harbor LLM backends (Ollama, vLLM, etc.) via API calls
  • Access SearXNG for web search in workflows
  • Store files in Harbor's shared volumes
  • Call other Harbor services via internal network

Troubleshooting

Check Logs
# All services
harbor logs windmill

# Specific service
harbor logs windmill-server
harbor logs windmill-worker
Database Issues

If migrations fail or database is corrupted:

# Stop services
harbor down windmill

# Remove database (WARNING: destroys all data)
rm -rf services/windmill/db

# Restart
harbor up windmill
Worker Issues

If jobs are stuck or failing:

# Check worker logs
harbor logs windmill-worker

# Restart windmill
harbor restart windmill

Links

Home | CLI Reference | Services | Adding New Service | Compatibility

Clone this wiki locally