Inboxorcist

DigitalOcean App Platform provides managed infrastructure with easy scaling.

App Spec Deployment

Step 1: Fork the Repository

Fork the Inboxorcist repository to your GitHub account.

Step 2: Update App Spec

Edit deploy/do-app-spec.yaml and replace YOUR_USERNAME with your GitHub username:

github:
  repo: YOUR_USERNAME/inboxorcist
  branch: main

Step 3: Create the App

Using the DigitalOcean CLI:

doctl apps create --spec deploy/do-app-spec.yaml

Or through the dashboard:

Log in to DigitalOcean
Go to Apps > Create App
Select GitHub and connect your repository
Choose Use App Spec and upload deploy/do-app-spec.yaml

Step 4: Configure Environment Variables

In the App settings, add these environment variables:

# Required - Security
JWT_SECRET=your-jwt-secret-min-32-chars
ENCRYPTION_KEY=your-64-character-hex-encryption-key

# App URL (your DigitalOcean domain)
APP_URL=https://your-app.ondigitalocean.app

# Optional - Google OAuth (can also be configured via /setup UI)
# GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
# GOOGLE_CLIENT_SECRET=GOCSPX-your-secret

Mark JWT_SECRET and ENCRYPTION_KEY as Secret.

Google OAuth credentials are optional. You can configure them via the web UI at /setup after deployment.

Step 5: Deploy

Click Deploy or push to the connected branch.

App Spec Reference

name: inboxorcist
region: nyc

services:
  - name: inboxorcist
    dockerfile_path: Dockerfile
    github:
      repo: YOUR_USERNAME/inboxorcist
      branch: main
      deploy_on_push: true
    http_port: 6616
    instance_size_slug: basic-xxs
    instance_count: 1
    health_check:
      http_path: /health
      initial_delay_seconds: 10
      period_seconds: 30
    envs:
      - key: JWT_SECRET
        scope: RUN_TIME
        type: SECRET
      - key: ENCRYPTION_KEY
        scope: RUN_TIME
        type: SECRET
      - key: APP_URL
        scope: RUN_TIME
        value: https://your-app.ondigitalocean.app

Database Options

Option A: DigitalOcean Managed PostgreSQL (Recommended)

Add a managed database to your app spec:

databases:
  - name: db
    engine: PG
    version: "16"
    size: db-s-dev-database
    num_nodes: 1

Then reference it in your service:

services:
  - name: inboxorcist
    envs:
      - key: DATABASE_URL
        scope: RUN_TIME
        value: ${db.DATABASE_URL}

Option B: External PostgreSQL

If you have an existing PostgreSQL database (e.g., Supabase, Neon, or your own):

Go to your app's Settings > Environment Variables
Add DATABASE_URL with your connection string:
```
postgres://user:password@host:5432/dbname
```