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

# Deploy Manifest on Coolify

> Deploy Manifest on Coolify 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/manifest/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/manifest/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 Manifest encryption key are generated and stay stable between deployments.

## Open Manifest

After deployment, open the generated Manifest URL and create the first admin account. The first account 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.
* Generated session, encryption, database password, and public URL values.

## Production notes

* Keep the PostgreSQL volume backed up through Coolify or your server provider.
* 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)
