> ## Documentation Index
> Fetch the complete documentation index at: https://manifest.build/llm-gateway/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy the LLM Gateway on Coolify

> Deploy the Manifest LLM Gateway with a Docker Compose service stack, generated secrets, and a private PostgreSQL container.

<Card title="View Coolify template" icon="external-link" href="https://github.com/mnfst/llm-gateway/tree/main/deploy/coolify">
  Self-hosted PaaS path using Docker Compose, Coolify magic variables, and
  PostgreSQL.
</Card>

## Overview

Coolify is a strong fit for Manifest because its one-click services are Docker Compose templates. Until Manifest is accepted into the Coolify service catalog, you can paste the Compose file from the Manifest repository into a user-defined service stack.

## Prerequisites

* A Coolify instance or Coolify Cloud account.
* A server destination configured in Coolify.
* A domain or wildcard domain configured for Coolify's proxy.

This stack runs on infrastructure you control through Coolify. Your server, storage, and bandwidth costs depend on your provider.

## Deploy

1. Open your Coolify project.
2. Click **New Resource**.
3. Choose **Docker Compose Empty** or a user-defined service stack.
4. Paste the contents of [`deploy/coolify/docker-compose.yml`](https://github.com/mnfst/llm-gateway/blob/main/deploy/coolify/docker-compose.yml).
5. Save the service.
6. Confirm Coolify generated values for:
   * `SERVICE_URL_MANIFEST_2099`
   * `SERVICE_PASSWORD_POSTGRES`
   * `SERVICE_HEX_64_AUTH`
   * `SERVICE_HEX_64_ENCRYPTION`
7. Deploy.

The Compose file uses Coolify magic environment variables so the app URL, Postgres password, Better Auth secret, and gateway encryption key are generated and stay stable between deployments.

## Open the gateway

After deployment, open the generated gateway URL and create the first admin account. Fresh installs redirect to `/setup`; the first account you create becomes the admin.

Verify the deployment:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -fsS https://<your-coolify-domain>/api/v1/health
```

## What Gets Provisioned

* Manifest Docker image `manifestdotbuild/manifest:6`.
* PostgreSQL 16 container.
* Persistent Docker volume for PostgreSQL data.
* Persistent Docker volume for request logs.
* Generated session, encryption, database password, and public URL values.

## Production notes

* Back up both Docker volumes through Coolify or your server provider: PostgreSQL data and request logs.
* Use a real domain with HTTPS before enabling OAuth or email-based login flows.
* The Compose file is the starting point for a future official Coolify one-click service template.

Relevant Coolify docs:

* [Coolify services](https://coolify.io/docs/services/introduction)
* [Coolify Docker Compose](https://coolify.io/docs/knowledge-base/docker/compose)
* [Coolify environment variables](https://coolify.io/docs/knowledge-base/environment-variables)