Guides

Guides

Choose a task, follow the steps, and use the matching CLI or SDK reference when you need more detail.

New to Openship? Complete the quickstart first.

Deploy

TaskGuide
Deploy a repositoryGitHub or Git URL and templates
Deploy files from your machineLocal folders
Deploy code generated by an applicationGenerated code and source files
Run an app and its supporting servicesCompose and multiple services
Deploy branches separatelyPreview environments
Deploy on pushAutomatic deployments
Return to an earlier releaseRollback and redeploy

Configure

TaskGuide
Declare configuration in your repositoryopenship.json
Set environment variables and secretsEnvironment variables
Add a hostname and HTTPSCustom domains
Keep data across deploymentsPersistent and object storage
Set CPU, memory, and sleep behaviorResources and sleep
Clone private repositoriesGit authentication
Register a GitHub AppSelf-hosted GitHub Apps

Operate

TaskGuide
Inspect traffic, logs, and healthLogs and monitoring
Schedule commandsJobs
Protect and restore dataBackups and restores
Connect an SSH serverCustom servers
Manage the reverse proxyThe edge
Update OpenshipUpdates
Manage accessTeams and members
Run mail and webmailEmail
Manage Cloud chargesBilling

Move

TaskGuide
Import from another platformCoolify, Dokploy, and Dokku
Move between serversServer-to-server migration
Move Openship's own dataControl-plane migration
Connect or move to CloudCloud connection and migration
Run application schema changesDatabase migrations

Extend

Build a catalog app, integrate the SDK, call the HTTP API, or connect an MCP client.

On this page