Repo of the Day
biolend83/tubehaus
Published: Nov 16, 2026
Open repository ↗Your own YouTube on your own server: fast, private, never blocked (Cloudflare WARP), with live streams and real-time captions. Self-hosted, one docker compose
Summary
TubeHaus is a YouTube client available as a self-hosted web service and as native apps for Android/TV, Windows, macOS, Linux, and iPhone/iPad. It provides familiar browsing, playback, subscriptions, history, and playlists without requiring a Google account; the server connects to YouTube through Cloudflare WARP and exposes Invidious-compatible API routes.
What it is useful for
The server is useful for a household that wants one shared YouTube-style library across browsers, phones, and a TV while operating the endpoint and library itself. The web interface includes home, search, channels, playlists, comments, transcripts, live captions generated with whisper.cpp, and a remote-friendly TV mode.
The native apps add offline downloads, background playback, picture-in-picture, and an mpv player on desktop. They can also connect to a TubeHaus server: video playback remains local to the app, while subscriptions, history, and playlists are shared with the server.
For integration work, the server answers routes such as /api/v1/videos and /api/v1/search using Invidious API shapes. The README says clients such as Yattee and FreeTube’s API mode may work, although Invidious-specific account and login features are not included.
There are documented boundaries. The project is described as young and beta, with one maintainer. The iOS build is also beta, requires sideloading, and must be re-signed every seven days with a free Apple ID. Some optional browser lookups still go directly to SponsorBlock, DeArrow, and Return YouTube Dislike. TubeHaus streams content from YouTube; it retains the library and short-lived files for offline downloads rather than storing the full video catalog.
How engineers can use it
The documented Docker deployment requires Linux with Docker Compose, at least two CPU cores, about 4 GB of RAM, and roughly 10–20 GB of disk space. Clone the repository, configure the environment file, and start the services:
git clone https://github.com/biolend83/tubehaus && cd tubehaus
cp .env.example .env # set your domain
docker compose pull
docker compose up -d
Before exposing a public address, configure authentication. The README documents basic authentication for a shared login, per-person accounts, or OpenID Connect; without any authentication, everyone who opens the address shares the same library.
After deployment, check the WARP connection, YouTube access, search, and stream lookup with:
docker compose exec tubehaus python3 /app/server/tubehaus_server.py --doctor
For updates from version 1.5 or earlier, the README notes that the former Invidious, companion, and PostgreSQL services are no longer required.