selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Tiramisu logo

Self-host Tiramisu

v1.11.8

BitTorrent engine with FUSE virtual filesystem for streaming

ReleaseOpen SourceOther
Updatedlast week
LanguageGo
Setup difficultyAdvanced
Stars
149
CPU
linux/amd64 with AVX2 strongly recommended (Intel Haswell/AMD Excavator or later); linux/arm64 (NEON mandatory)
RAM
4 GB RAM recommended (Raspberry Pi 4 baseline)
Storage
SSD recommended for warmup cache (reference Pi deployment uses 32 GB)
Ports
8090 (GoStorm API, JSON torrent management), 9080 (Control Panel, Metrics, Dashboard, Webhook, Scheduler, Library API)
Requires
Plex or Jellyfin, Samba, SQLite
Docker
mrrobotogit/tiramisu
Install with Docker
Tiramisu demo showing click play on a torrent, streaming starts in about a secondTiramisu Control Panel overviewPlex library populated by sync scriptsTiramisu interactive installerHealth Monitor Dashboard with status grid and sync controls

What is Tiramisu?

Should you self-host Tiramisu?

Tiramisu scores 47/100 on selfhost.directory (how scoring works) and ranks #40 of 54 in Media Streaming. It has 149 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v1.11.8, came out on 17 October 2026. New versions land roughly every 1 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Other-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Invidious (81/100, 25 799 stars). It scores higher overall, so compare the two before you pick. See Tiramisu vs Invidious side by side.

Features

  • 4K HDR Dolby Vision Support
  • Adaptive Chunk Size
  • Adaptive Shield
  • Automatic Library Sync
  • Control Panel
  • FUSE Virtual Filesystem
  • Health Monitor Dashboard
  • IP blocklistOptional and off by default
  • Live BitTorrent Streaming
  • Music and Audiobook Support
  • NAT-PMP for WireGuard
  • PEXChurn
  • Plex/Jellyfin Webhooks
  • Plex Watchlist Integration
  • TailHedge

Tiramisu README

How to install Tiramisu

Install Tiramisu with Docker

Docker with FUSE support, --device /dev/fuse, --cap-add SYS_ADMIN, --cap-add NET_ADMIN

docker pull mrrobotogit/tiramisu:latest

or docker pull ghcr.io/mrrobotogit/tiramisu:latest

docker run -d
--name tiramisu
--restart unless-stopped
--device /dev/fuse
--cap-add SYS_ADMIN
--cap-add NET_ADMIN
-v /path/to/config.json:/config.json
-v /path/to/state:/state
-v /mnt/tiramisu-mkv-real:/mnt/tiramisu-mkv-real
-v /mnt/tiramisu-mkv-virtual:/mnt/tiramisu-mkv-virtual:rshared
-p 8090:8090
-p 9080:9080
mrrobotogit/tiramisu:latest

Requires Docker with FUSE support (/dev/fuse). On some Ubuntu hosts --privileged may be needed instead of individual capabilities.

Tiramisu releases & version history

FAQ

Is my data private?

Everything runs on your own hardware. No account or third-party API key is required for the core engine (TMDB, Prowlarr, and Plex/Jellyfin integrations are optional and use your own credentials).

Is this legal?

Tiramisu is a general-purpose BitTorrent engine and streaming filesystem. It does not host, index, or distribute any copyrighted content itself; what you do with it is your responsibility, same as with any BitTorrent client.

Does it work with Sonarr, Radarr, or other *Arr tools?

Not directly. Tiramisu has its own built-in sync engine that talks to TMDB, Prowlarr, and Torrentio to discover and add titles automatically, so it does not need the *Arr suite to function.

What hardware do I need?

A Raspberry Pi 4 (4 GB RAM) is the tested minimum baseline and comfortably handles 4K HDR streaming. Any linux/amd64 or linux/arm64 machine works: NAS, VPS, mini-PC, or any always-on Linux box.

Do I need to seed or keep uploading?

Tiramisu participates in the swarm while a file is open, but retention drops automatically once playback stops. No long-term seeding is required or expected.

Does Tiramisu store or download the files?

No persistent copy of the media is kept. Byte ranges pass through RAM and an optional bounded SSD cache (first/last few MB of each file) and are never written to disk as complete files. There is no storage quota.

How is this different from Real-Debrid or other debrid services?

Debrid services are third-party paid subscriptions that cache torrents on someone else's servers. Tiramisu runs entirely on your own hardware with no subscription, no third-party server, and no monthly fee — the BitTorrent swarm itself is the source.

What is Tiramisu?

Tiramisu is a self-hosted BitTorrent engine with a built-in FUSE virtual filesystem that presents torrents as normal, seekable .mkv files to Plex or Jellyfin, streaming bytes live from the swarm as they are read with no download step or temp files.

More in Media Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…