Documentation

Production operations for an application intentionally running on one server. Start with What Onebox is.

Quickstart

Install → Your first deploy → Reading the file back

Browse the documentation

Get started

• What Onebox is
• Install
• Your first deploy
• Reading the file back

Guides

• Add a database
• Back up a database
• Handle secrets
• Run migrations safely
• Schedule a job
• Roll back a release
• Deploy through a jump host
• Environment variables
• Adopt an existing Compose file
• Eject
• Upgrade to onebox names

Reference

• Project file
• Top-level fields
• Workloads
• Services
• Environments
• Runtime
• Deployment
• Checks
• Proxy
• Hooks
• Registries
• Notifications
• Backup targets
• External services
• CLI commands
• Error codes
• Service drivers
• Policies
• Naming
• Shipped vs proposed

Concepts

• The ownership boundary
• Evidence, not declaration
• Why Compose is generated
• What Onebox refuses
• The safety envelope

For agents: llms.txt lists the documentation; every page has a Markdown version at <path>.md, including this page.