Skip to content

Docker Compose Apps

A Docker Compose App runs a set of containers from a Docker Compose file on your FlyWP server. Use it for anything that isn't WordPress, Node.js or a one-click app, like a database with a web frontend, or a stack you already run with Docker Compose.

FlyWP validates your Compose file, saves a managed copy, and deploys it to your server. Every app gets dedicated management pages for domains, deploys, settings, backups, and logs. Explore the guides below to learn how each part works.

A running app's Overview page, with the app sidebar (Overview, Domains, Deploys, Configurations, Backups, Logs and Settings) and the Services card

Make sure you have:

  • A paid FlyWP plan (Docker Compose Apps aren't available on the Free plan).
  • A server in your team that supports apps (trial servers can't run them).
  • A server with at least 512 MB of memory. The creation flow displays each app's memory requirements, and templates that require more RAM than your server has free are flagged.
  • A team owner or team admin role. Other roles can't create apps.

If any requirement isn't met, the Create Site dialog explains why on the Docker Compose App card and prevents you from continuing.

A server can be large enough and still have no room. If its other apps use all the memory it sets aside for apps, the card says: "No memory is free for Docker Compose Apps on this server: its other apps use it." Lower the limits of those apps on their Resources pages, or choose another server.

  • Start from a template, paste a Compose file, link to a remote file, or select a file from a GitHub repository.
  • Connect one or more domains and let FlyWP automatically secure them with SSL. See Domains and SSL.
  • Update environment variables, edit the Compose file, adjust resource limits, and apply your changes with a new deploy.
  • Roll back, redeploy, compare versions, and deploy automatically on each push to a branch.
  • Schedule automatic backups, take manual snapshots on demand, and restore them.
  • Stream live logs and download log files.
  • Clone or transfer the app to another server in your team.

The Domains page lists every domain of your app, the service and port each one goes to, its SSL state, and its status. The main domain has a Main badge. It is the address FlyWP shows for the app. To remove the main domain, make another domain main first.

For a domain that is waiting for DNS, two buttons appear in its row: Check DNS again and the lock button (Certificate). Add an A record that points the name to your server, remove any AAAA record for the name, then click Check DNS again. If a certificate fails, the lock button reads Try SSL again. Once the name points to your server, SSL starts on its own.

Use the lock button to add your own certificate or a Cloudflare Origin certificate instead.

Still stuck? How can we help?

View as Markdown