Deploy and Host Vaze on Railway

Vaze is a self-hosted, local-first file storage and hosting service built with Next.js and SQLite. Deployed easily via Docker, it provides a clean web interface for managing files and a robust API—complete with an official NPM package—to serve as a reliable storage backend for your other applications.

About Hosting Vaze

Deploying Vaze on Railway is straightforward thanks to its Dockerized architecture. By using the template you'll simply deploy the official Docker image, but have everything set up for you.

Because Vaze uses SQLite for its internal database, there is no need to provision a separate, complex database service; everything is self-contained. Once the container is live and your custom domain is routed, visiting the web interface allows you to register the initial admin account instantly.

Common Use Cases

Acting as a dedicated file-hosting backend for other full-stack applications using the official NPM package.
Serving as a personal, privacy-focused alternative to mainstream cloud storage providers with full UI management.
Securely distributing downloadable assets, folders, or zipped archives via managed API keys.

Dependencies for Vaze Hosting

None

Deployment Dependencies

Official darseen/vaze Docker image

Implementation Details

Vaze is used without any modifications. It comes with all the necessary features enabled for a production environment.

Additionally, if you are setting up a custom domain to act as your BASE_URL, managing your DNS records through a provider like Cloudflare and pointing them to your Railway public network URL will ensure secure and reliable routing to your API and dashboard.

Environment Variables

The following environment variables should be set. If not set, the default values will be used.

BASE_URL: The base URL of your Vaze instance.
AUTH_SECRET: A secret key used to sign JWT tokens.

Why Deploy Vaze on Railway?

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

By deploying Vaze 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.