Deploy and Host SimpleHub on Railway

SimpleHub is an open-source AI API management and monitoring platform that helps you manage multiple AI providers from a single dashboard. It supports balance monitoring, automatic check-ins, model synchronization, notifications, and centralized management for providers like NewAPI, Velora, VOAPI, DoneHub, and many others.

About Hosting SimpleHub

Deploying SimpleHub on Railway provides a fast and reliable way to manage your AI API providers without maintaining servers or infrastructure. Railway automatically provisions networking, HTTPS, and persistent storage while SimpleHub offers a modern web interface for monitoring API balances, tracking model availability, performing automatic check-ins, and receiving notifications. The Railway template is production-ready and uses SQLite with persistent storage by default, so no external database is required. After deployment, simply open the dashboard, configure your API providers, and begin monitoring all of your AI services from one centralized location.

Common Use Cases

Monitor balances and usage across multiple AI API providers.
Manage OpenAI-compatible API gateways from a single dashboard.
Track model availability and receive notifications when models change.
Automate daily check-ins for supported AI platforms.
Centralize AI provider management for personal or team environments.

Dependencies for SimpleHub Hosting

The Railway template automatically deploys everything required.

Required before deployment

None

Optional

SMTP settings for email notifications (optional, if configured)
Initial administrator credentials (if supported by your image version)

SimpleHub uses SQLite with persistent storage by default, so no external database or Redis service is required.

Deployment Dependencies

GitHub Repository: https://github.com/jwy87/SimpleHub
Docker Image: https://github.com/jwy87/SimpleHub/pkgs/container/simplehub
Documentation: https://github.com/jwy87/SimpleHub

Configuration

Required Environment Variables

None

The Railway template is ready to deploy without any environment variables.

Optional Environment Variables

Variable	Description
`ADMIN_EMAIL`	Administrator email (if supported).
`ADMIN_PASSWORD`	Administrator password (if supported).
`SMTP_HOST`	SMTP server for email notifications.
`SMTP_PORT`	SMTP server port.
`SMTP_USER`	SMTP username.
`SMTP_PASS`	SMTP password.
`SMTP_FROM`	Sender email address.

Most users do not need to configure any environment variables before deployment. Provider configuration, monitoring, and application settings are managed directly from the SimpleHub web dashboard after deployment.

Features

AI API provider management
Balance monitoring
Automatic check-ins
Model synchronization
Notification support
Multi-provider dashboard
SQLite database with persistent storage
Modern responsive web interface
Production-ready Docker deployment

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.