Deployment Overview
Choose the best deployment method for your needs.
Inboxorcist can be deployed in multiple ways depending on your needs. All methods support the full feature set.
Comparison
| Method | Difficulty | Database | Best For |
|---|---|---|---|
| Single Binary | Easiest | SQLite or PostgreSQL | Personal use, VPS, cloud servers (Recommended) |
| Docker | Easy | PostgreSQL | Users who prefer containers |
| Railway | Very Easy | PostgreSQL | Quick cloud deployment |
| Render | Very Easy | PostgreSQL | Automatic deploys from Git |
| Fly.io | Easy | PostgreSQL | Global edge distribution |
| DigitalOcean | Easy | PostgreSQL | Managed PaaS |
| Custom VPS | Easy | SQLite or PostgreSQL | Maximum control |
Recommended: The single binary is the simplest way to deploy Inboxorcist. It supports both SQLite and PostgreSQL, requires zero dependencies, and works on any VPS or cloud server.
Prerequisites for All Methods
Before deploying, you'll need:
- Google OAuth Credentials - Setup guide
- Security Secrets - Generated by the setup script or manually:
# Generate JWT_SECRET (32+ characters)
openssl rand -base64 32
# Generate ENCRYPTION_KEY (64 hex characters)
openssl rand -hex 32Architecture Options
Binary (Recommended)
The binary runs as a single process with your choice of database:
┌─────────────────────────────┐
│ Inboxorcist Binary │
│ (API + SPA on :6616) │
└─────────────┬───────────────┘
│
▼
┌─────────────────┐
│ SQLite (local) │ ← Default: zero setup
│ OR │
│ PostgreSQL │ ← Cloud deployments
└─────────────────┘Docker
Docker deployment with bundled PostgreSQL:
┌─────────────────────────────────┐
│ Docker Container │
│ ┌─────────────────────────┐ │
│ │ Inboxorcist Server │ │
│ │ (API + SPA on :6616) │ │
│ └────────────┬────────────┘ │
└───────────────┼─────────────────┘
│
▼
┌─────────────────┐
│ PostgreSQL │
└─────────────────┘Quick Start Commands
Binary (Recommended):
curl -fsSL https://inboxorcist.com/install.sh | bashDocker:
docker compose up -d