[Skip to content](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#start-of-content) You signed in with another tab or window. [Reload](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md) to refresh your session.You signed out in another tab or window. [Reload](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md) to refresh your session.You switched accounts on another tab or window. [Reload](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md) to refresh your session.Dismiss alert {{ message }} [andrewhack](https://github.com/andrewhack)/ **[stremio-libtorrent-server](https://github.com/andrewhack/stremio-libtorrent-server)** Public - [Notifications](https://github.com/login?return_to=%2Fandrewhack%2Fstremio-libtorrent-server) You must be signed in to change notification settings - [Fork\\ 0](https://github.com/login?return_to=%2Fandrewhack%2Fstremio-libtorrent-server) - [Star\\ 3](https://github.com/login?return_to=%2Fandrewhack%2Fstremio-libtorrent-server) ## Collapse file tree ## Files main Search this repository(forward slash)` forward slash/` / # README.md Copy path Blame More file actions Blame More file actions ## Latest commit [![andrewhack](https://avatars.githubusercontent.com/u/46722365?v=4&size=40)](https://github.com/andrewhack)[andrewhack](https://github.com/andrewhack/stremio-libtorrent-server/commits?author=andrewhack) [Net: dual-stack BT listener + port-follows-env publish (0.2.21)](https://github.com/andrewhack/stremio-libtorrent-server/commit/1d340403b7275b313bf02a58df6a434d103573ed) Open commit details 6 hours agoJul 4, 2026 [1d34040](https://github.com/andrewhack/stremio-libtorrent-server/commit/1d340403b7275b313bf02a58df6a434d103573ed) · 6 hours agoJul 4, 2026 ## History [History](https://github.com/andrewhack/stremio-libtorrent-server/commits/main/README.md) Open commit details [View commit history for this file.](https://github.com/andrewhack/stremio-libtorrent-server/commits/main/README.md) History 325 lines (253 loc) · 20.4 KB / # README.md Copy path Top ## File metadata and controls - Preview - Code - Blame 325 lines (253 loc) · 20.4 KB [Raw](https://github.com/andrewhack/stremio-libtorrent-server/raw/refs/heads/main/README.md) Copy raw file Download raw file You must be signed in to make or propose changes More edit options Outline Edit and raw actions # 🎬 stremio-libtorrent-server [Permalink: 🎬 stremio-libtorrent-server](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-stremio-libtorrent-server) ### Your own Stremio streaming server — open, fast, and _yours_. One command to run it. 🚀 [Permalink: Your own Stremio streaming server — open, fast, and yours. One command to run it. 🚀](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#your-own-stremio-streaming-server--open-fast-and-yours-one-command-to-run-it-) Self-host the **complete Stremio experience** — the **web player** _and_ a powerful, open **BitTorrent streaming engine** — in a single container on your own hardware. It's a **full torrent** **client**, not just a streamer: it downloads whole files and can **pin favorites to keep & seed**. Point any Stremio client (browser, Android TV, Tizen, webOS, desktop) at it and press play. No subscription. No tracking. No black box. **100% free and open — our gift to the community.** 💛 > **Sharing back with the community. 💛** This is a real torrent client, so a title you started keeps > **downloading to completion and seeding (uploading) back to other Stremio users** even after you > close the player — that's how you help keep the swarm fast and healthy **for everyone**. Unpinned > titles are cleared automatically; **pin** the ones you'd like to keep sharing. Prefer to limit it? > Cap up/down bandwidth in the settings any time — your box, your call. [![Docker Hub](https://camo.githubusercontent.com/e829672ebd6254ac20451a013dcf82001f7ffbf1f3af58939f5c824ec19767ec/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f636b65722532304875622d616e64726f736861636b253246737472656d696f2d2d6c6962746f7272656e742d2d7365727665722d3234393645443f6c6f676f3d646f636b6572266c6f676f436f6c6f723d7768697465)](https://hub.docker.com/r/androshack/stremio-libtorrent-server)[![License: MIT](https://camo.githubusercontent.com/7ce445fb52c8e3a953faefef1f14242bf5f2d9dcf4c4ef5bc05c1d0edc68a28d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d3344413633392e737667)](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/LICENSE) * * * ## ✨ Why you'll love it [Permalink: ✨ Why you'll love it](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-why-youll-love-it) - **🚀 Install in one command.**`docker run …` — that's the whole setup. No building, no config files. - **📺 Just works on TVs.** Automatic **trusted HTTPS** (a real Let's Encrypt cert) that smart TVs actually accept — zero certificate headaches. - **⚡ Faster, more reliable.** Unlike the closed stock server, this one **accepts inbound peers** and fetches **playhead-first**, so streams start quicker and hold up on thin swarms. - **🎛️ Truly yours to control.** Real dials for cache, buffering, peers, and transcode — tune deeply, or never touch a thing. - **🖥️ Hardware transcode, optional.** Intel **VAAPI** / NVIDIA **NVENC** when you expose a GPU to the container (opt-in — see [Advanced](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-advanced--tune-it-your-way)), with graceful CPU fallback — and a missing GPU never stops it from starting. - **🧩 Your addons, your choice.** It's **neutral infrastructure**: it streams whatever a Stremio addon hands it. It bundles no content and is not a source. - **🔓 Open source.** Read it, change it, trust it. * * * ## 🚀 Quick Start — anyone can do this [Permalink: 🚀 Quick Start — anyone can do this](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-quick-start--anyone-can-do-this) > **Architecture:** the published image is **`linux/amd64` (x86-64) only**. It runs on any normal > PC/server/NAS. ARM hosts (Raspberry Pi, most ARM TV boxes, Apple Silicon) aren't supported by the > prebuilt image — build from source on those. **1.** Install [Docker](https://docs.docker.com/get-docker/). **2.** Copy **one** command below — whichever matches your hardware — and replace `YOUR_SERVER_IP` with your machine's LAN IP (e.g. `192.168.1.50`). **Not sure which? Use the first one — it works on** **everything.** _(The GPU options only speed up the occasional video that needs converting; they're not required.)_ **💻 No GPU — works everywhere (start here)** ``` docker run -d --name stremio --restart unless-stopped \ -e IPADDRESS=YOUR_SERVER_IP \ -p 8080:8080 -p 12470:12470 -p 6881:6881/tcp -p 6881:6881/udp \ -v stremio-data:/root/.stremio-server \ androshack/stremio-libtorrent-server ``` **🟦 Intel / AMD GPU (VAAPI)** — same, plus `--device /dev/dri` ``` docker run -d --name stremio --restart unless-stopped \ -e IPADDRESS=YOUR_SERVER_IP \ --device /dev/dri:/dev/dri \ -p 8080:8080 -p 12470:12470 -p 6881:6881/tcp -p 6881:6881/udp \ -v stremio-data:/root/.stremio-server \ androshack/stremio-libtorrent-server ``` **🟩 NVIDIA GPU (NVENC)** — plus `--gpus all` (first install the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) on the host) ``` docker run -d --name stremio --restart unless-stopped \ -e IPADDRESS=YOUR_SERVER_IP \ --gpus all \ -p 8080:8080 -p 12470:12470 -p 6881:6881/tcp -p 6881:6881/udp \ -v stremio-data:/root/.stremio-server \ androshack/stremio-libtorrent-server ``` **🟦🟩 Both Intel + NVIDIA** — both flags ``` docker run -d --name stremio --restart unless-stopped \ -e IPADDRESS=YOUR_SERVER_IP \ --gpus all --device /dev/dri:/dev/dri \ -p 8080:8080 -p 12470:12470 -p 6881:6881/tcp -p 6881:6881/udp \ -v stremio-data:/root/.stremio-server \ androshack/stremio-libtorrent-server ``` **3.** Open it: - 🌐 **In a browser (same network):**`http://YOUR_SERVER_IP:8080` — _browser playback covers MP4/H.264; for MKV/HEVC content use the **desktop or TV** apps (browsers can't decode those)._ - 🔒 **Trusted HTTPS (and TVs):** run `docker logs stremio` and use the printed URL — **it looks like**`https://192-168-1-50.519b6502d940.stremio.rocks:12470` _(replace `192-168-1-50` with your internal IP, dots written as dashes)_. Sign into Stremio, add your addons, press play. 🍿 _(Prefer a file? Grab [`compose.hub.yaml`](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/compose.hub.yaml) → `IPADDRESS=YOUR_SERVER_IP docker compose -f compose.hub.yaml up -d`.)_ * * * ## 🧰 Minimum hardware [Permalink: 🧰 Minimum hardware](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-minimum-hardware) It's light — direct play (most content) barely touches the CPU; the GPU only matters for transcoding. | Resource | Minimum | Recommended | Notes | | --- | --- | --- | --- | | **CPU** | 2 cores, x86-64 | 4+ cores | `amd64` only. Transcoding (clients that can't direct-play) is the only heavy load. | | **RAM** | 1 GB | 2 GB+ | Engine + buffers + nginx; transcoding adds ~0.5–1 GB. | | **Disk** | ~3 GB + cache | SSD, cache ≥ largest file | Image ~1.5 GB; download cache defaults to **18 GiB** (tune with `STREMIOSRV_CACHE_SIZE`). Keep free space ≥ your biggest single file. | | **GPU** | none | Intel VAAPI / NVIDIA NVENC | Optional — only speeds up transcoding; a missing/broken GPU never blocks startup. | | **Network** | any | wired + `6881` forwarded | Wired beats Wi-Fi for 4K; forward port `6881` for the full swarm (see below). | * * * ## 📺 On your TV [Permalink: 📺 On your TV](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-on-your-tv) Smart TVs insist on a **trusted** HTTPS connection — a self-signed cert won't do. Set `IPADDRESS` and this server fetches a real Let's Encrypt certificate for you automatically (via Stremio's `*.stremio.rocks` magic DNS, which maps that long URL back to your server's IP — even on your LAN). In the TV's Stremio app, set the **Streaming Server URL** to the `…stremio.rocks:12470` address shown by `docker logs stremio`. > **Note — the Stremio _desktop_ app (v6).** The desktop shell launches its own bundled streaming > server and re‑points itself at `127.0.0.1:11470` on **every** start — it injects a > `?streamingServerUrl=` parameter that overwrites the saved URL — so simply setting the Streaming > Server URL doesn't stick. (This is the shell's behaviour, not a `serverVersion` gate — that part is > already correct.) Two ways to use **this** box from the desktop: > > - **Best — launch with a flag** _(native player, full MKV/HEVC):_ start Stremio with > `--development --webui-url=` (the trusted URL from > `docker logs stremio`). A non‑default `--webui-url` skips the localhost injection and loads the > player from this box; `--development` also skips the unused bundled server. Add the flag to your > shortcut and launch from it each time. It **must** be the **trusted**`:12470` URL — a self‑signed > cert is refused. After signing into your account, relaunch via the shortcut (login resets the URL). > - **Zero‑install** _(MP4/H.264 only):_ open the `:12470` URL in a browser, or install it as an app. > > **TVs are unaffected** — Samsung/LG accept the `:12470` URL directly and it sticks. * * * ## 🌍 Want the _full_ swarm? Forward one port. [Permalink: 🌍 Want the full swarm? Forward one port.](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-want-the-full-swarm-forward-one-port) A lot of BitTorrent's speed comes from peers reaching **you** — and home routers block that by default. For maximum peers and throughput, **forward port `6881` (TCP _and_ UDP)** on your router to your server. It works fine without forwarding — you'll just reach fewer peers on sparse torrents. (Unlike the stock server, this one actually _listens_ for inbound peers, so the forward genuinely pays off.) * * * ## 🔐 Run behind a VPN [Permalink: 🔐 Run behind a VPN](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-run-behind-a-vpn) Tunnel only the streaming server's BitTorrent traffic through a VPN (kill-switch + optional port-forwarding) using [gluetun](https://github.com/qdm12/gluetun), while your LAN keeps reaching the player/admin directly: ``` WIREGUARD_PRIVATE_KEY=... WIREGUARD_ADDRESSES=10.2.0.2/32 IPADDRESS= \ docker compose -f compose.vpn.yaml up -d ``` Notes: - The VPN's **kill-switch** is on by default — if the tunnel drops, torrent traffic stops (no IP leak). - **Inbound peers / seeding** need a provider that supports **port-forwarding** (e.g. ProtonVPN, PIA, AirVPN). Without it you still stream, but with outbound-only connectivity. - Set `FIREWALL_OUTBOUND_SUBNETS` to your LAN CIDR(s) so the player and admin stay reachable. * * * ## 🔧 Advanced — tune it your way [Permalink: 🔧 Advanced — tune it your way](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-advanced--tune-it-your-way) Everything is a plain `-e NAME=value` environment variable: | Setting | Default | What it does | | --- | --- | --- | | `IPADDRESS` | _(unset)_ | Your server IP → auto **trusted TV cert** via `*.stremio.rocks`. Unset → self-signed. | | `SERVER_URL` | auto | URL the web player targets. Set for a custom domain. | | `STREMIOSRV_CACHE_SIZE` | `19327352832` (18 GiB) | Download-cache budget in bytes (LRU-evicted). Keep it **above your largest file**. | | `STREMIOSRV_READAHEAD_BYTES` | `134217728` (128 MiB) | Playhead buffer — bigger absorbs more swarm jitter (fewer rebuffers). | | `STREMIOSRV_BT_LISTEN_PORT` | `6881` | BitTorrent peer port (TCP **and** UDP, IPv4 **and** IPv6). The one to forward. **If you change it, publish the _same_ port** — the compose files and `docker/launch.sh` follow this var automatically; a hand-rolled `docker run` must use matching `-p :/tcp -p :/udp` (mapping to a _different_ container port silently kills inbound peering). | | `STREMIOSRV_BT_MAX_CONNECTIONS` | `400` | Max peer connections. | | `STREMIOSRV_DOWNLOAD_RATE_LIMIT` | `0` | Cap download throughput in **bytes/sec** (`0` = unlimited). E.g. `12500000` ≈ 100 Mbit/s. | | `STREMIOSRV_UPLOAD_RATE_LIMIT` | `0` | Cap upload throughput in **bytes/sec** (`0` = unlimited). Handy so seeding doesn't saturate your line. | | `STREMIOSRV_IDLE_DOWNLOAD_RATE_LIMIT` | `1048576` (1 MiB/s) | **Cross-torrent playback priority.** While _anything_ is being streamed, every _other_ (idle) torrent is capped to this many bytes/sec so the torrent you're watching wins the bandwidth. `0` disables it (idle torrents compete freely). | | `STREMIOSRV_MAX_STREAMS` | `0` | Max **concurrent playbacks** (distinct torrents being streamed). A new play past the cap gets `503`. `0` = unlimited. | | `STREMIOSRV_SEED_ON_COMPLETE` | `true` | Keep seeding after a torrent finishes (full torrent-client behaviour). `false` = **stop seeding + drop peers** the moment it completes. Pinned items always keep seeding. | | `STREMIOSRV_MAX_SEED_MINUTES` | `0` | Stop seeding this many **minutes after completion** (`0` = seed forever). Applies on top of `SEED_ON_COMPLETE`. | | `STREMIOSRV_EXTRA_TRACKERS` | _(empty)_ | Extra trackers appended to **every** torrent (on top of the built-in defaults). Comma/space/newline-separated `udp://`/`http(s)://`/`ws(s)://` URLs. | | `STREMIOSRV_TRACKER_LIST_URL` | _(empty)_ | Optional URL of a community tracker list (e.g. the raw [ngosang/trackerslist](https://github.com/ngosang/trackerslist)`trackers_best.txt`). Fetched in a **background thread** to keep the list current — best-effort, **never blocks startup or playback**; offline falls back to the last cached list, then the built-in defaults. Empty = fully static. | | `STREMIOSRV_TRACKER_LIST_REFRESH_HOURS` | `24` | How often the background tracker-list source re-fetches (only when a URL is set). | | `DOMAIN` | `localhost` | CN for the self-signed cert (when not using `IPADDRESS`). | | `CERT_FILE` | `certificates.pem` | Bring-your-own cert (full-chain + key) filename in the data volume. | **Trackers & peer discovery.** Every torrent is announced to a curated set of public trackers (baked-in defaults) **plus DHT, LSD and PEX** — so a bare infohash finds peers even when the magnet carries no tracker, exactly like the stock Stremio server. Extend it two ways: add your own with `STREMIOSRV_EXTRA_TRACKERS`, or point `STREMIOSRV_TRACKER_LIST_URL` at a maintained list (e.g. [ngosang/trackerslist](https://github.com/ngosang/trackerslist)) to keep the set current — that fetch runs in a background thread and **never blocks startup or playback** (offline → last cached list → the built-in defaults). The bigger peering win, though, is **inbound connectivity**: forward `STREMIOSRV_BT_LISTEN_PORT` (6881) so you reach the whole swarm, not just what trackers hand back. **GPU transcode** (only for clients that can't direct-play). Docker does **not** expose the host GPU to a container by default, so the one-command install above is **CPU-only**. The server _auto-detects_ a GPU, but only one you've handed in — so opt in at launch: - **Intel/AMD VAAPI** → add `--device /dev/dri:/dev/dri` - **NVIDIA NVENC** → add `--gpus all` (requires the [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) on the host) - **Or just use [`docker/launch.sh`](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/docker/launch.sh)** — it probes the host and adds the right flags for you, degrading gracefully (a broken or absent driver never blocks startup). Full NVIDIA driver + **Proxmox** **passthrough** setup: [NVIDIA-GPU.md](https://github.com/andrewhack/stremio-docker/blob/main/NVIDIA-GPU.md) (companion fork). **Your own domain instead of stremio.rocks:** put a full-chain+key PEM as `certificates.pem` in the data volume, set `-e SERVER_URL=https://yourdomain:12470`, and leave `IPADDRESS` unset. **Tailscale (zero port-forwarding, trusted HTTPS):** if you reach the server over a [Tailscale](https://tailscale.com/) tailnet, you can skip both port-forwarding _and_ the `*.stremio.rocks` dependency. Provision a cert for the node's MagicDNS name (`tailscale cert ..ts.net`), concatenate the cert + key into one PEM, drop it in the data volume as `certificates.pem`, and set `-e SERVER_URL=https://..ts.net:12470` with `IPADDRESS` unset. Point your devices' Stremio **Streaming Server URL** at that tailnet address — works across your own devices and anyone you share the tailnet with, with a browser/TV-trusted cert. **Ports:**`8080` web+API (HTTP/LAN) · `12470` web+API (HTTPS) · `11470` direct API · `6881` BitTorrent. 📖 Full ops guide: [`docs/DEVOPS.md`](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/docs/DEVOPS.md) · TLS deep-dive: [`docs/cert-guide.md`](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/docs/cert-guide.md). * * * ## 🧠 Why it exists [Permalink: 🧠 Why it exists](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-why-it-exists) The stock Stremio streaming server is closed-source and, in practice: - **outbound-only** — it never listens for inbound peers, so you only reach the connectable half of a swarm; - it **hides the torrent levers** — no real control over piece picking, connectivity, or cache. This opens it up: **inbound connectivity + playhead-first piece picking** for faster starts and better reliability on sparse swarms, **plus** hardware transcode for clients that can't direct-play — all in an image you run yourself. It is **content-neutral infrastructure**: it streams whatever infohash a Stremio _addon_ hands it, and bundles or surfaces nothing. ## 🏗️ Under the hood [Permalink: 🏗️ Under the hood](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#%EF%B8%8F-under-the-hood) One image, two source repos. The runtime image is built **`FROM`** a GPU/ffmpeg base (the companion fork) and layers the open server on top: ``` ┌─────────────── stremio-docker-dual (companion fork, MIT) ──────────────┐ │ jellyfin-ffmpeg (NVENC/VAAPI) · nginx · bundled Stremio web player │ └───────────────────────────────▲──────────────────────────────────────────┘ │ FROM ┌─────────────── stremio-libtorrent-server (this repo) ──────────────────┐ │ FastAPI + libtorrent engine · nginx serves web player + proxies the API │ │ → one container: web player + open engine on a single origin │ └────────────────────────────────────────────────────────────────────────────┘ ``` Companion fork: **[andrewhack/stremio-docker](https://github.com/andrewhack/stremio-docker)** (builds the `stremio-docker-dual` image; see its [`NVIDIA-GPU.md`](https://github.com/andrewhack/stremio-docker/blob/main/NVIDIA-GPU.md) for GPU/Proxmox setup). Modules: `api/` (Stremio HTTP API) · `torrent/` (libtorrent + piece-picker) · `stream/` (Range file server) · `transcode/` (ffmpeg NVENC/VAAPI → HLS) · `config.py` · `health.py`. Protocol reference: [`docs/protocol-map.md`](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/docs/protocol-map.md). ## ✅ Status [Permalink: ✅ Status](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-status) All stages shipped and verified on hardware: | Stage | Scope | State | | --- | --- | --- | | 0–1 | Protocol map · FastAPI skeleton · `/health` | ✅ | | 2 | Torrent core + direct play (inbound peers, head & holes, Range serving, stats) | ✅ | | 3 | Transcode / HLS (`hlsv2`, NVENC/VAAPI) | ✅ | | 4 | Subtitles · `opensubHash` · casting | ✅ | | 5 | Productionise — compose, DEVOPS, healthcheck, AHM | ✅ | | 6 | All-in-one (web player + engine) · TV-trusted SSL · GPU-optional · Docker Hub | ✅ | ## 🛠️ Development [Permalink: 🛠️ Development](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#%EF%B8%8F-development) ``` uv sync uv run pytest -q # unit tests uv run ruff check . # lint uv run uvicorn stremiosrv.app:create_app --factory --host 0.0.0.0 --port 11470 ``` ## 🔐 Appendix — how the TV HTTPS URL works (`*.stremio.rocks`) [Permalink: 🔐 Appendix — how the TV HTTPS URL works (*.stremio.rocks)](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-appendix--how-the-tv-https-url-works-stremiorocks) _Skip this unless you're curious or customizing certs — the Quick Start needs none of it._ When you set `IPADDRESS`, the container prints a TV-ready HTTPS URL like: ``` https://192-168-1-50.519b6502d940.stremio.rocks:12470 └────┬─────┘ └────┬─────┘ └─────┬─────┘ └─┬─┘ your IP, shared ID Stremio's HTTPS dashed (see below) free DNS port ``` - **`192-168-1-50`** — your server's IP with dots turned into dashes. - **`…stremio.rocks`** — a free service Stremio runs that (a) resolves `.…stremio.rocks` back to that IP (even a LAN IP — no DNS setup by you), and (b) carries a **trusted Let's Encrypt** **wildcard cert**, so TVs/browsers accept the HTTPS connection with no warning. - **`:12470`** — the container's HTTPS port. A TV opening it → resolves to your server's IP → connects on `12470` → sees a trusted cert → connects. The name resolves to your **internal** IP, so the TV must be on the **same network** (normal home setup). For **remote** access, use your **public** IP in the URL and forward port `12470`. ### About `519b6502d940` — a shared, third-party dependency [Permalink: About 519b6502d940 — a shared, third-party dependency](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#about-519b6502d940--a-shared-third-party-dependency) This ID belongs to **Stremio's own certificate service**, not to any docker image: the cert is fetched from Stremio's API (`api.strem.io/api/certificateGet`), which issues it for a subdomain of Stremio's `stremio.rocks` domain. It is **not unique to your install** — everyone running this (or the upstream [tsaridas/stremio-docker](https://github.com/tsaridas/stremio-docker)) image shares the same `*.519b6502d940.stremio.rocks` wildcard cert from **Stremio's free certificate service**. The image only _calls_ that Stremio API; it didn't create the ID. - ✅ Zero-config trusted HTTPS for TVs. - ⚠️ It depends on Stremio's cert service keeping that wildcard alive; if it's ever rotated or taken down, the automatic cert path stops working (your stream still runs — only the trusted-HTTPS URL is affected). **Independent fallback — bring your own cert** (no reliance on stremio.rocks): put a full-chain + key PEM as `certificates.pem` in the data volume, set `-e SERVER_URL=https://yourdomain:12470`, and **leave** **`IPADDRESS` unset** — the server uses your cert as-is. Or, on a trusted LAN, skip HTTPS entirely and use `http://:8080`. ## 📜 License & spirit [Permalink: 📜 License & spirit](https://github.com/andrewhack/stremio-libtorrent-server/blob/main/README.md#-license--spirit) **MIT** — built on the MIT-licensed [stremio-docker](https://github.com/tsaridas/stremio-docker) fork. This is **not a commercial product, and we don't monetize it.** It's our contribution to the people who just want their own open, private streaming server. Use it, share it, make it better. 💛 > Keep it legal: this is neutral infrastructure for content **you** have the right to stream. You can’t perform that action at this time.