Help
Install, update, connect hosts, licences, backups and the fixes for common problems. Every step is checked against the current Containly version.
Guides
- Install ContainlyInstall Containly with Docker Compose or docker run, create the first admin with the setup token and put it behind a reverse proxy.
- Update ContainlyUpdate Containly with one click in the app, or with docker compose pull and up, and what happens to your data.
- Add hosts and endpointsConnect more Docker hosts to Containly over TCP with TLS, over SSH or with the outbound agent, and how many hosts the free tier covers.
- Activate and move a licenceActivate a Containly Pro key, how it works offline, and how to move a licence to another installation.
- Back up and restore dataBack up and restore stacks, containers and volumes with Containly: targets, database dumps, anonymous volumes, scheduled plans, S3, SFTP, SMB and NFS, restore to another host, retention, download and import.
- TroubleshootingBlack or blank page, the installed app stays black, licence server unreachable, licence active on another installation, endpoint limit, lost setup token, backups failing with "No such image", grouped lists that show only headers, resetting a user password.
- Change your planSwitch Pro from monthly to annual, upgrade a subscription to Lifetime and buy more licences. The licence key stays the same.
- Containly account, data and supportAccount settings, sign-in security, invoices, support requests and the guided support chat.
- Group lists with viewsShow containers, images, volumes, networks and backups as a list or grouped by stack, image, driver, resource type or host. Collapsed groups, paging and selection explained.
- Automate with workflowsWorkflows (Pro, Containly 2.7.0) react to unhealthy containers, offline hosts, finished backups or a schedule with safe, predefined steps. Templates, drafts, scope, simulate, run now, circuit breaker and history explained.
- Notification channels (ntfy, Gotify, webhook)Since Containly 2.7.1 notifications also go to ntfy, Gotify or any webhook. Free for normal notifications, Pro inside workflows. Setup, test button, filters, webhook format with HMAC signature, security rules and delivery log explained.
- Push notifications and Discord, Telegram, Slack, PushoverSince Containly 2.7.2 notifications also reach Discord, Telegram, Slack and Pushover, and your phone or browser as web push through the installed app. Free for normal notifications, Pro inside workflows. Setup per service, push on iPhone and Android, filters and security explained.
- API tokens and CI redeploySince Containly 2.7.3 personal API tokens let GitHub Actions, Gitea or Forgejo Actions and other pipelines redeploy a stack with one curl, and Prometheus read the metrics. Free. Scopes, security, job status and ready examples.
- Prometheus and GrafanaSince Containly 2.7.3 Containly exposes /metrics for Prometheus: endpoint up, host CPU, memory and disk, container state, health, restarts, CPU and memory. Free, off by default, protected by a metrics token. Scrape config, metric list and Grafana queries.
- Compose override filesSince Containly 2.7.3 compose.override.yaml and every other compose file Docker used for a project are passed to each action, version updates find tags in override files, and the editor shows override files as tabs. How Containly picks the files.