# Guides
URL: https://openship.io/docs/guides.md

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](/docs/getting-started/quickstart) first.

## Deploy

| Task | Guide |
| --- | --- |
| Deploy a repository | [GitHub](/docs/guides/deploy-from-github) or [Git URL and templates](/docs/guides/deploy-template-or-url) |
| Deploy files from your machine | [Local folders](/docs/guides/deploy-local-folder) |
| Deploy code generated by an application | [Generated code and source files](/docs/api/sources) |
| Run an app and its supporting services | [Compose and multiple services](/docs/guides/compose-multi-service) |
| Deploy branches separately | [Preview environments](/docs/guides/preview-environments) |
| Deploy on push | [Automatic deployments](/docs/guides/auto-deploy) |
| Return to an earlier release | [Rollback and redeploy](/docs/guides/rollback-redeploy) |

## Configure

| Task | Guide |
| --- | --- |
| Declare configuration in your repository | [openship.json](/docs/guides/openship-json) |
| Set environment variables and secrets | [Environment variables](/docs/guides/environment-variables) |
| Add a hostname and HTTPS | [Custom domains](/docs/guides/custom-domains) |
| Keep data across deployments | [Persistent and object storage](/docs/guides/persistent-storage) |
| Set CPU, memory, and sleep behavior | [Resources and sleep](/docs/guides/sleep-mode-resources) |
| Clone private repositories | [Git authentication](/docs/guides/git-authentication) |
| Register a GitHub App | [Self-hosted GitHub Apps](/docs/guides/self-hosted-github-app) |

## Operate

| Task | Guide |
| --- | --- |
| Inspect traffic, logs, and health | [Logs and monitoring](/docs/guides/logs-monitoring) |
| Schedule commands | [Jobs](/docs/guides/jobs) |
| Protect and restore data | [Backups and restores](/docs/guides/backups-restore) |
| Connect an SSH server | [Custom servers](/docs/guides/custom-servers) |
| Manage the reverse proxy | [The edge](/docs/guides/the-edge) |
| Update Openship | [Updates](/docs/guides/updating) |
| Manage access | [Teams and members](/docs/guides/teams-members) |
| Run mail and webmail | [Email](/docs/guides/email-webmail) |
| Manage Cloud charges | [Billing](/docs/guides/billing) |

## Move

| Task | Guide |
| --- | --- |
| Import from another platform | [Coolify, Dokploy, and Dokku](/docs/guides/migrate-from-coolify-dokploy-dokku) |
| Move between servers | [Server-to-server migration](/docs/guides/server-to-server-migration) |
| Move Openship's own data | [Control-plane migration](/docs/guides/migrate-control-plane) |
| Connect or move to Cloud | [Cloud connection and migration](/docs/guides/cloud-connect-migration) |
| Run application schema changes | [Database migrations](/docs/guides/database-migrations) |

## Extend

Build a [catalog app](/docs/guides/add-an-app), integrate the [SDK](/docs/api/sdk), call the
[HTTP API](/docs/api), or connect an [MCP client](/docs/mcp).
