Inboxorcist

Fly.io runs your app on servers close to your users worldwide. Great for low-latency access from anywhere.

Prerequisites

Install the Fly CLI:

# macOS
brew install flyctl

# Linux
curl -L https://fly.io/install.sh | sh

# Windows
powershell -Command "iwr https://fly.io/install.ps1 -useb | iex"

fly auth login

Deployment Steps

Step 1: Launch the App

From the repository root:

fly launch --config deploy/fly.toml

When prompted:

App name: inboxorcist (or your preferred name)
Region: Choose the closest to you
PostgreSQL: No (unless you want it)
Redis: No (unless you want it)

Step 2: Create a Volume

Create persistent storage for SQLite:

fly volumes create inboxorcist_data --size 1 --region iad

Replace iad with your chosen region.

Step 3: Set Secrets

# Set Google OAuth credentials
fly secrets set GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
fly secrets set GOOGLE_CLIENT_SECRET=GOCSPX-your-secret

# Generate and set security secrets
fly secrets set JWT_SECRET=$(openssl rand -base64 32)
fly secrets set ENCRYPTION_KEY=$(openssl rand -hex 32)

# Set app URL (replace with your app name)
fly secrets set APP_URL=https://inboxorcist.fly.dev

Step 4: Deploy

fly deploy

Step 5: Update Google OAuth

Add your Fly.io URL to Google Cloud Console:

Go to Google Cloud Console
Edit your OAuth client

Add redirect URI:

https://inboxorcist.fly.dev/auth/google/callback

Configuration Reference

The deploy/fly.toml file:

app = 'inboxorcist'
primary_region = 'iad'

[build]
  dockerfile = "Dockerfile"

[http_service]
  internal_port = 6616
  force_https = true
  auto_stop_machines = true
  auto_start_machines = true
  min_machines_running = 0

[[vm]]
  memory = "512mb"
  cpu_kind = "shared"
  cpus = 1

[mounts]
  source = "inboxorcist_data"
  destination = "/app/data"

[[http_service.checks]]
  path = "/health"
  grace_period = "10s"

Adding PostgreSQL (Optional)

Create a Fly Postgres cluster:

fly postgres create --name inboxorcist-db
fly postgres attach inboxorcist-db

Fly automatically sets DATABASE_URL in your app.

Adding Redis (Optional)

For persistent job queues:

fly redis create --name inboxorcist-redis

Then set the connection URL:

fly secrets set REDIS_URL=redis://...

Custom Domain

# Add certificate
fly certs add yourdomain.com

# View DNS instructions
fly certs show yourdomain.com

Update your DNS records as instructed, then update environment variables:

fly secrets set APP_URL=https://yourdomain.com

Scaling

Scale Memory/CPU

fly scale memory 1024
fly scale vm shared-cpu-2x

Scale Instances

fly scale count 2

Scale Regions

Deploy to multiple regions:

fly regions add lhr fra
fly scale count 3

Monitoring

View Logs

fly logs

Check Status

fly status

Open Dashboard

fly dashboard

SSH into Machine

fly ssh console

Updating

Deploy the latest changes:

fly deploy

Pricing

Fly.io's free tier includes:

3 shared-cpu-1x VMs
160GB outbound bandwidth
3GB persistent volumes

Troubleshooting

Deployment Fails

Check build logs:

fly logs --instance <instance-id>

Health Check Fails

Verify the health endpoint:

fly ssh console -C "curl http://localhost:6616/health"

Volume Not Mounted

Ensure volume exists in the correct region:

fly volumes list

Secrets Not Applied

Redeploy after setting secrets:

fly secrets list
fly deploy

Fly.io

On this page