Deploy and Host Cobalt Web UI on Railway

Self-hosted beautiful web interface for your Cobalt Tools API.

This template deploys the official Cobalt web frontend so you can use a clean and modern web UI connected to your self-hosted Cobalt API.

Important: This template only deploys the Web UI. You must deploy the Cobalt Tools API separately.

About Hosting Cobalt Web UI

Hosting the Cobalt Web UI allows you to run a beautiful frontend for your self-hosted Cobalt Tools instance. Instead of relying on the public cobalt.tools website or using only the API, you can deploy your own web interface that connects directly to your Cobalt API.

This Web UI communicates with your Cobalt API to process media download requests from supported platforms such as YouTube, TikTok, Instagram, Twitter/X, Reddit, and more.

The template is designed to work together with the existing Cobalt Tools API deployment.

Common Use Cases

• Self-hosted web interface for Cobalt Tools
• Beautiful frontend connected to your private Cobalt API
• Easy media downloader experience with your own backend
• Multiple Web UIs connected to a single Cobalt API
• Personal or team media workflow with custom UI

Dependencies for Cobalt Web UI Hosting

Deployment Dependencies

Before deploying this template, you must first deploy the Cobalt Tools API:

Deploy Cobalt Tools API here: https://railway.com/deploy/cobalt-tools

After the API is running, copy its public Railway domain. You will need to set this as the value for the WEB_DEFAULT_API environment variable.

This template uses the community-maintained Docker image:

ghcr.io/spotdemo4/cobalt-web:latest

No database, Redis, or persistent volume is required for this deployment.

Environment Variables

Important: WEB_DEFAULT_API

You must configure WEB_DEFAULT_API with the public URL of your Cobalt Tools API.

Example:

WEB_DEFAULT_API=https://your-cobalt-api.up.railway.app/

Always include the trailing slash (/) at the end of the URL.

Deployment

1. Deploy the Cobalt Tools API first using this link:
   • https://railway.com/deploy/cobalt-tools
2. Once the API is running, copy its public Railway domain.
3. Deploy this Cobalt Web UI template.
4. Set the WEB_DEFAULT_API environment variable to your Cobalt API URL.
5. Deploy the service and wait for it to complete.
6. Access the Web UI using the public domain provided by Railway.

Why Deploy Cobalt Web UI on Railway?

Railway simplifies deploying and connecting multiple services without managing servers or infrastructure. This template lets you quickly add a beautiful, self-hosted web interface to your Cobalt Tools API with minimal effort. You maintain full control over both the frontend and backend while enjoying automatic SSL, domains, and scaling provided by Railway.