Skip to main content

Linux Server Deployment

When you outgrow the Mac appliance, deploy OpRelay to any Linux server. Same Docker Compose, same architecture.

Requirements​

  • Linux server (Ubuntu 22.04+ recommended)
  • Docker and Docker Compose
  • 2GB+ RAM
  • PostgreSQL 16 (bundled or external)

Deploy​

git clone https://github.com/oprelay/oprelay.git
cd oprelay

# Optional: point to external Postgres
export DATABASE_URL="postgres://user:pass@your-db:5432/oprelay"

docker compose up -d

Production considerations​

  • Use an external managed Postgres for durability
  • Put a reverse proxy (nginx/Caddy) in front for SSL
  • Set JWT_SECRET to a stable value
  • Configure firewall to expose only port 443

OCI (Oracle Cloud)​

OpRelay runs well on OCI A1.Flex instances (ARM-based, generous free tier):

# SSH into your OCI instance
ssh ubuntu@your-oci-ip

# Follow standard Docker install
# Then clone and start OpRelay