diff --git a/maintenance-ops/self-hosting/coolify.mdx b/maintenance-ops/self-hosting/coolify.mdx index 963dcf736..de8e4d406 100644 --- a/maintenance-ops/self-hosting/coolify.mdx +++ b/maintenance-ops/self-hosting/coolify.mdx @@ -7,12 +7,16 @@ description: "Deploy the self-hosted PowerSync Service on Coolify with Docker Co [Coolify](https://coolify.io/) is an open-source, self-hosted platform that simplifies the deployment and management of applications, databases, and services on your own infrastructure. Think of it as a self-hosted alternative to platforms like Heroku or Netlify. - Before following this guide, you should: + Use this guide for development or a small deployment, meaning one that a single PowerSync Service container can handle. The [API Containers](/maintenance-ops/self-hosting/deployment-architecture#api-containers) section of Deployment Architecture gives the current connection limit per container. - - Read through the [Service Configuration](/configuration/powersync-service/self-hosted-instances) guide to understand the requirements and configuration options. This guide assumes you have already done so, and will only cover the Coolify specific setup. - - Have Coolify installed and running. + The Compose file in this guide runs the PowerSync Service and its MongoDB storage together on one Coolify server. Coolify's [multi-server deployments](https://coolify.io/docs/core/infrastructure/scaling/multi-server-deployments) do not support Docker Compose applications, so you cannot spread this setup across servers. When you outgrow one container, move to a platform that runs several behind a load balancer, such as [AWS ECS](/maintenance-ops/self-hosting/aws-ecs) or [AWS EKS](/maintenance-ops/self-hosting/aws-eks), and follow the [production deployment architecture](/maintenance-ops/self-hosting/deployment-architecture#production). +## Prerequisites + +- Read the [Service Configuration](/configuration/powersync-service/self-hosted-instances) guide first. This page covers only the Coolify side and assumes you know the Service's configuration options. +- Install Coolify and make sure it's running. + ## Background For the PowerSync Service to function correctly, you will need: