🚀 Docker Compose

Deploy: https://os.loca.zone

⚡ One-Line Install

curl -fsSL https://raw.githubusercontent.com/HeyPuter/puter/main/install.sh | sh

Action: Gens .env/config.json, pulls compose, up -d.

🧱 Services

• App: ghcr.io/heyputer/puter
• Proxy: Nginx (TLS/routing)
• DB: MariaDB
• Cache/Rate: Valkey
• KV: DynamoDB-local
• Blob: RustFS (S3)

🌐 Network & TLS

• DNS: Wildcards required (*.os.loca.zone).
• Certs: Certbot DNS challenge. Drop in ./puter/tls/.

🔄 Proxy Rules

If bypassing bundled Nginx:

1. Preserve Host.
2. domain: os.loca.zone in config.
3. X-Forwarded-Proto & X-Forwarded-For.
4. Adjust trust_proxy.

🛠️ Ops

• Update: pull && up -d
• Logs: logs -f puter
• Nuke: down && rm -rf puter/data (Irreversible)