Skip to main content

Open DigitalOcean deploy

App Platform deploy from the public repository with Manifest and a Dev PostgreSQL database.

Overview

DigitalOcean App Platform can create a Manifest app from the public repository template. The template uses the public Manifest Docker image and provisions a Dev PostgreSQL database.

Prerequisites

  • A DigitalOcean account with billing enabled.
  • Access to App Platform in the selected region.
  • A private DigitalOcean Space and an access key pair for it, for request logs.
This stack creates paid resources, including an App Platform service and Dev PostgreSQL database.

Deploy

  1. Open the DigitalOcean deploy link.
  2. Review the app spec.
  3. Generate two separate secret values:
  1. Paste one value into BETTER_AUTH_SECRET.
  2. Paste the other value into MANIFEST_ENCRYPTION_KEY.
  3. Fill in the recording storage secrets with your Space’s settings: REQUEST_RECORDING_S3_BUCKET, REQUEST_RECORDING_S3_ENDPOINT, REQUEST_RECORDING_S3_ACCESS_KEY_ID, and REQUEST_RECORDING_S3_SECRET_ACCESS_KEY. The region defaults to us-east-1, which DigitalOcean Spaces accepts as a signing region.
  4. Create the app.
DigitalOcean reads .do/deploy.template.yaml from the Manifest repository. The template includes the Manifest service and a Dev PostgreSQL database.

Open Manifest

After App Platform finishes deploying, open the app URL and create the first account. Fresh installs redirect to /setup; the first account you create becomes the admin. Verify the deployment:

Notes

  • App Platform has no persistent volumes, so request logs write to your DigitalOcean Space over S3.
  • The template appends uselibpqcompat=true to DigitalOcean’s PostgreSQL URL so Node pg handles the platform’s sslmode=require connection string correctly.
  • Upgrade the Dev Database to a managed database for production data.
  • Use a custom domain before configuring production OAuth callbacks.
Relevant DigitalOcean docs: