Deploy and Host SimpleHub on Railway

SimpleHub is an API aggregation monitoring and management platform designed to centrally manage multiple AI API gateways and OpenAI-compatible platforms. It provides automated health checks, balance monitoring, model change detection, daily check-ins, notifications, and scheduling features through a modern web interface.

About Hosting SimpleHub

Hosting SimpleHub requires running a persistent web application together with durable storage for its internal database and application configuration. The application uses SQLite by default and stores all site configurations, monitoring history, authentication data, notification settings, and scheduling information locally.

Railway simplifies deployment by allowing SimpleHub to run as a single Docker service with an attached persistent volume. Railway manages networking, deployments, HTTPS, domains, monitoring, and automatic restarts, while the attached volume ensures that application data survives redeployments and upgrades.

This makes Railway an ideal hosting platform for both personal monitoring dashboards and production monitoring environments managing dozens or hundreds of API providers.

Common Use Cases

• Monitor balances, quotas, and availability across multiple AI API providers from a single dashboard.
• Automatically detect model additions, removals, and configuration changes across OpenAI-compatible API gateways.
• Automate daily check-ins and reward collection for supported API platforms while receiving email notifications for important events.

Dependencies for SimpleHub Hosting

• Persistent storage volume mounted at /app/data
• Public HTTP networking for web access

Deployment Dependencies

• SimpleHub Docker Image: ghcr.io/jwy87/SimpleHub:latest

• Official Repository: https://github.com/jwy87/SimpleHub

• Railway Platform: https://railway.com

Implementation Details

SimpleHub stores its SQLite database and runtime files inside the following directory:

/app/data

Railway templates should attach a persistent volume to this location to prevent data loss between deployments.

Recommended environment variables:

ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=StrongPassword123!
JWT_SECRET=
ENCRYPTION_KEY=

Recommended Railway volume configuration:

Volume Mount Path:
/app/data

Recommended Railway networking configuration:

Public Networking: Enabled
Port: 3000

Why Deploy SimpleHub on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying SimpleHub on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

Railway removes the operational overhead of managing Docker hosts, reverse proxies, SSL certificates, storage provisioning, and deployment automation, allowing you to focus entirely on monitoring and managing your API infrastructure.