---
title: "Deploy Cobalt Web UI"
description: "Self-hosted beautiful web interface for your Cobalt Tools API"
category: "Other"
url: https://railway.com/deploy/cobalt-web-ui
---

# Deploy Cobalt Web UI

Self-hosted beautiful web interface for your Cobalt Tools API

**[Deploy Cobalt Web UI on Railway](https://railway.com/template/cobalt-web-ui)**

- **Creator:** codestorm
- **Category:** Other
- **Total deploys:** 8

## Template content

### cobalt-web https://res.cloudinary.com/dh2nt6hgh/image/upload/v1759035050/cobalt_logo_zlnnac.png

- **Image:** ghcr.io/spotdemo4/cobalt-web:latest
- **Public domain:** Yes

## Documentation

# 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.

![Cobalt Web UI](https://imgur.com/4kBxy2C.png)

> **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

| Variable            | Description                                              | Default     | Required |
|---------------------|----------------------------------------------------------|-------------|----------|
| `WEB_DEFAULT_API`   | URL of your Cobalt Tools API (must include trailing slash) | (empty)     | **Yes**  |
| `WEB_HOST`          | Public domain of this Web UI instance                    | Auto-filled | Recommended |
| `PORT`              | Internal port used by the web server                     | `8787`      | No       |
| `LOG_LEVEL`         | Logging level (`info`, `debug`, `warn`, etc.)            | `info`      | No       |

### 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.

## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/cobalt-web-ui