Skip to main content

Open Koyeb deploy

Deploy-button guide for Koyeb using the public Docker image, manual Postgres URL, and runtime secrets.

​
Overview

Koyeb can deploy Manifest from the public Docker image with a Deploy to Koyeb button. The button pre-fills the image, HTTP port, and runtime settings, but you must create PostgreSQL separately and replace the placeholder secrets before deploying.

​
Prerequisites

  • A Koyeb account.
  • A Koyeb PostgreSQL Database Service.
  • Two random 32+ character secrets for Manifest.
This deployment creates paid resources if your selected Koyeb service or database plan is not free.

​
Create PostgreSQL

In Koyeb, create a PostgreSQL Database Service in the same region you plan to use for Manifest. After it is ready, open the database connection details and copy the connection string. Manifest uses TLS to connect to Koyeb Postgres, so include sslmode=require in the connection string. If the copied URL has no query string, append ?sslmode=require. If it already has query parameters, append &sslmode=require.

​
Generate secrets

Generate separate values for session signing and at-rest provider credential encryption: 
openssl rand -hex 32
openssl rand -hex 32

​
Deploy Manifest

  1. Open the Koyeb deploy link.
  2. Replace DATABASE_URL with your Koyeb Postgres connection string.
  3. Replace BETTER_AUTH_SECRET with the first generated secret.
  4. Replace MANIFEST_ENCRYPTION_KEY with the second generated secret.
  5. Leave BETTER_AUTH_URL as https://{{ KOYEB_PUBLIC_DOMAIN }}.
  6. Leave PORT, MANIFEST_MODE, BIND_ADDRESS, DB_POOL_MAX, and AUTH_DB_POOL_MAX unchanged for a single-instance deploy.
  7. Deploy the service.
The button deploys docker.io/manifestdotbuild/manifest:6 and exposes port 2099 over HTTP.

​
Open Manifest

After the deployment is live, open the public Koyeb domain and create the first account. The first account becomes the admin. Verify the deployment: 
curl -fsS https://<your-koyeb-domain>/api/v1/health

​
Tearing it down

Delete both resources when you are done:
  • The Manifest Koyeb Web Service.
  • The Koyeb PostgreSQL Database Service.
Deleting only the web service leaves the database running. Relevant Koyeb docs: