ZenSailor Documentation
ZenSailor is the self-hosted PaaS that gets out of your way. Ship code faster, manage infrastructure effortlessly, and own your data.
Getting Started
- IntroductionWhat ZenSailor is, and what it does for you.
- ArchitectureHow the control plane, agents and Traefik fit together.
- InstallationInstall ZenSailor on a fresh Linux server with one command.
- Requirements and PlansWhat your server needs before installing, and what each plan unlocks.
- Resource StructureOrganizations, projects, environments and services explained.
- First StepsCreate your admin account and configure your first instance.
- Licensing and ActivationConnect a paid plan to your self-hosted control plane.
Deploying
- Services and SourcesDeploy from Git, Docker images, Compose files or templates.
- Deployment PipelineHow the queue, build, health gates and rollback work.
- Deploy WindowsRestrict when a service is allowed to build and deploy.
- Preview EnvironmentsEvery pull request gets its own running copy of your app.
- Environment Variables and SecretsScoped variables, injection methods and secret delivery.
- Compose OverridesTune a compose service without forking the file.
- Webhooks and CI/CDTrigger deployments from pipelines and external tools.
Services
- Logs, Terminal and FilesDay-2 runtime tools for services and containers.
- Templates and Managed DatabasesOne-click stacks from a maintained catalogue, and provisioned databases.
- AutomationScheduled tasks: restarts, redeploys and scaling on a cron.
- Container WorkbenchInspect and operate every container on every node.
Networking
Storage
Backups and Recovery
Nodes
Organizations
Security
Administration
- UpdatingKeep your instance on the latest release.
- RepairDiagnose and fix a broken instance.
- UninstallingCleanly remove ZenSailor from your server.
- Platform SettingsWhat the instance-wide settings control.
- NotificationsGet told when deployments, health, nodes and backups change.
- AI ProvidersConnect a model provider for log and deployment analysis.
Integrations
CLI Reference
- CLI OverviewManage ZenSailor from your terminal with the zensailor CLI.
- Getting Started with the CLIAuthentication, configuration and shell completion.
- Organizations, Projects and EnvironmentsThe org/project/env pattern from the terminal.
- Service CommandsDeploy, operate and maintain services from the terminal.
- Nodes, Containers and SystemFleet operations from the terminal.
- Networks, Domains, Templates and InstanceRemaining command groups in one reference.