VoidAuth Deployment Guide (Fly.io + Unmanaged PostgreSQL)

Replace voidauth with your own app name (for example: b4iterdev-voidauth) in commands where needed.

1) Create unmanaged Postgres on Fly

Create a Postgres cluster:

fly postgres create --name voidauth-pg --region iad

Save these values from the output (you will use them in Step 4):

• Postgres host
• Postgres password
• Postgres user/database (usually postgres)

---

2) Create VoidAuth app + persistent config volume

fly apps create voidauth
fly volumes create voidauth_config --app voidauth --region iad --size 1

---

3) Copy fly.toml in this repository and change app and primary_region field

Use the fly.toml in this repo, then update:

app = "voidauth"          # change to your Fly app name
primary_region = "sin"    # change to your preferred region

---

4) Set required secrets

fly secrets set -a voidauth \
  APP_URL="https://auth.yourdomain.com" \
  STORAGE_KEY="$(openssl rand -hex 32)" \
  DB_HOST="<flycast-postgres-host>" \
  DB_PASSWORD="<postgres-password>"

---

5) Customize branding/templates (optional)

Edit files under:

• customization/branding/custom.css
• customization/email_templates/**

At image build time, these are copied into /app/customization-seed. (Do not put these files under /opt because the hardened base image may not preserve/execute those paths as expected.) At startup, they are copied into /app/config (your Fly volume mount) before VoidAuth starts.

---

6) Deploy

fly deploy -a voidauth --ha=false

---

7) First login

Get startup logs:

fly logs -a voidauth --no-tail

On first startup, VoidAuth prints initial admin credentials in logs. Use those credentials to sign in, then create/update your permanent admin user immediately.