---
title: "Deploy Tronbyt"
description: "Self-hosted Tidbyt backend: run your LED displays without the Tidbyt cloud"
category: "Other"
url: https://railway.com/deploy/tronbyt-1
---

# Deploy Tronbyt

Self-hosted Tidbyt backend: run your LED displays without the Tidbyt cloud

**[Deploy Tronbyt on Railway](https://railway.com/template/tronbyt-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/tronbyt-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Tronbyt https://cdn.jsdelivr.net/gh/tronbyt/docs@60941ccfa7260834c97a6a866b3eb802f61712ef/docs/icons/web-app-manifest-512x512.png

- **Source:** https://github.com/aalfath/tronbyt-railway-template
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# Deploy and Host Tronbyt on Railway

Tronbyt is an open-source, self-hosted server for Tidbyt-style 64x32 LED displays. It replaces the Tidbyt cloud: it renders Pixlet apps from a catalogue of more than a thousand community apps, serves the frames to your devices, and builds firmware for Tidbyt Gen1/Gen2, Tronbyt S3 and similar boards. It needs no Tidbyt account or backend.

## About Hosting Tronbyt

This template runs Tronbyt server 2.6.1 as one service, built from a public GitHub repo that pins the official image by version and digest. All state lives on a Railway volume at `/app/data`: the SQLite database (users, devices, installed apps, settings), the app catalogue, firmware images and uploaded apps, so redeploys and restarts lose nothing. Railway gives the service a public HTTPS domain, and devices poll that URL for their next frame. A `/health` check gates each deploy. There are no default passwords: the first visitor creates the `admin` account, and open sign-up is off, so after that only the admin can add users.

## Common Use Cases

* Keep a Tidbyt running after the Tidbyt cloud, with apps that still work
* Run a Tronbyt S3, MatrixPortal or Raspberry Pi LED panel from your own server
* Develop and test your own Pixlet apps and push them to your displays

## Dependencies for Tronbyt Hosting

* A Tidbyt, Tronbyt or other supported LED display (optional for trying the web UI)
* A Railway volume for `/app/data` (included in this template)

### Deployment Dependencies

* Tronbyt server: https://github.com/tronbyt/server (release v2.6.1)
* Template repo: https://github.com/aalfath/tronbyt-railway-template
* Tronbyt documentation: https://tronbyt.com

### Implementation Details

After deploy:

1. Open the service's public URL right away and create the `admin` user with a strong password. This account can build firmware that contains your Wi-Fi password.
2. Click **New Tronbyt**, name the device and pick its hardware type, then use **Add App** to install apps from the catalogue.
3. For real hardware, open **Firmware** on the device, enter your Wi-Fi details, download the image and flash it (for example with the ESPHome web flasher). The firmware points the device at `https://YOUR-DOMAIN`.

The first start clones the app catalogue (about 250 MB) and downloads firmware to the volume, which takes under a minute.

Optional service variables: `ENABLE_USER_REGISTRATION=true` (lets anyone with the URL sign up), `SYSTEM_APPS_AUTO_REFRESH=true` (refreshes the app catalogue every 12 hours), `GITHUB_TOKEN` (higher GitHub rate limit), `REDIS_URL` (moves the app HTTP cache to Redis), `PIXLET_HTTP_BLOCK_PRIVATE_IPS=true`, and the `OIDC_*` variables for single sign-on.

Updates: the service builds from the template repo. When the pinned Tronbyt version is bumped there, Railway shows an "update available" notice on your project, and you choose when to apply it. Tronbyt migrates its database on start. Read the repo's CHANGELOG.md first.

## Why Deploy Tronbyt 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 Tronbyt 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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/tronbyt-1
