Your own cinema, in a browser tab.
Self-hosted movies and TV with direct play, smart transcoding, and no media library to store. Bring RealDebrid, TorBox, or an AIOStreams install.
streamvault.page · Why StreamVault · Comparisons · Features · Quick start · Sponsor
StreamVault is built and maintained by one developer. No company, no venture money, no paid tier. If it has earned a place in your setup, sponsoring is the most direct way to fund the next release.
Become a sponsor · from $1/month
Most media setups ask you to choose between a pile of moving parts and a client app on every device. StreamVault is one Docker stack and one URL.
- Nothing to download, nothing to store. Streams are resolved on demand. No terabytes of media, no download queue, no files to rename or deduplicate.
- Your debrid account, your choice. RealDebrid, TorBox, or both. With two keys, streams from each are queried together and merged. AIOStreams can aggregate the sources and debrid services you already run.
- One URL for every screen. Phone, tablet, laptop, TV browser. No app to install, no addon to configure per device, no platform support matrix.
- It picks the cheapest way to play. Direct play if the browser can handle the source, a low-cost remux if it nearly can, and a full transcode only if it cannot. Older hardware plays modern files.
- A real household setup. Separate accounts with their own library, history, wishlist, and language preferences. Child accounts with age limits and a lock password.
- Private by design. Your RealDebrid and TorBox keys are encrypted at rest, never written to logs, and never sent to the browser. No analytics, no third-party telemetry.
- Open source, MIT. Read it, change it, self-host it. There is no account with the author and no feature held back for a paid plan.
| StreamVault | Plex + Sonarr/Radarr | Stremio | |
|---|---|---|---|
| Time to first movie | One Compose stack, about ten minutes | Hours: indexers, download client, paths, naming, storage | Install the app, then add sources |
| Media storage | None. Streamed on demand | Full copies, often several terabytes | None |
| Debrid and sources | RealDebrid, TorBox, or AIOStreams | Your own downloads | Addons and debrid |
| Software to install | A browser | Plex app on every platform | Stremio app on every platform |
| Transcoding | Built in, automatic, per stream | Plex Pass for hardware transcoding | Depends on the device's codec support |
| Accounts | Per-user library, history, and languages | Managed users | One library per account |
| Child controls | Age caps, fail-closed, lock password | Rating limits per managed user | Not built in |
| Running cost | Server plus RealDebrid or TorBox | Server, disk, Plex Pass, indexers, VPN | Debrid service optional |
Different tools for different jobs. If you want a permanent offline library, a download stack is the better fit. StreamVault is for watching now, in a browser, with as little machinery as possible.
Continue watching, recommendations, your library and wishlist on one page.
Title pages carry the backdrop, ratings and every source, with the best cached one ready to play.

On a phone: the same rails, with a floating bottom bar.
- Search any movie or show, with posters, plots, cast, genres, and age ratings.
- Ratings from IMDb, Rotten Tomatoes, and Metacritic on every title.
- Popular and trending rows for films and TV, refreshed from live metadata.
- Recommendations based on what you have watched, using TMDB's collaborative filtering.
- Rich title pages with backdrop, overview, cast, ratings, seasons, and every available source.
- Playlists queue films and shows in your own order: add a title from its detail page, then reorder or remove it later.
- Three playback paths: native direct play, video remux, and full transcode. StreamVault picks the lightest one the source and browser can support.
- Audio track selection when a release carries multiple languages.
- Subtitle support for embedded text tracks and image formats (PGS, VobSub), with SubDL as a fallback when nothing is embedded. Bitmap subtitles are burned in because browsers cannot render them.
- Timestamp correction keeps audio and video aligned after a resume, a seek, or a recovery.
- Automatic stall recovery reconnects the stream and preserves the playhead before asking you to intervene.
- iPhone support through an HLS fallback for Safari, which lacks the MSE support the main player relies on.
- Keyboard controls, playback speed, volume, and precise seeking.
- Resume and progress tracking saved every few seconds and shared across sessions.
- Season and episode browser with air dates, overviews, and per-episode progress.
- Manual watched state for a movie, episode, season, or series, with season tabs and library progress kept in sync.
- Auto-advance to the next episode when one finishes.
- Skip to the next episode at a closing-credits chapter, or in the final seconds when no chapter exists. It is offered, never forced: no countdown, no automatic skip.
- Separate accounts, each with its own library, wishlist, watch history, and recommendations.
- Child accounts limited by age rating, resolved from OMDB and TMDB certifications and failing closed when a rating cannot be found.
- Child lock for turning restrictions off or changing the age limit.
- Language preferences: 17 audio languages, filtered and sorted per user, with a default track.
- Sign-ups disabled by default, so a public instance stays private until you open it.
- One Compose stack: Rails, PostgreSQL, and Solid Queue in a single deployment.
- Encrypted secrets: RealDebrid and TorBox keys are encrypted at rest with Active Record Encryption.
- Your choice of debrid service: RealDebrid and TorBox are both supported. Configure one or both; with both keys, streams from each are queried and merged. Each account can use its own key or share an administrator's team key.
- AIOStreams for aggregation: point StreamVault at an AIOStreams install and it serves the sources and debrid services configured there, with no per-account key needed.
- Health endpoint at
/upfor uptime checks. - No analytics and no call-home. The only outbound requests are to the metadata, stream, and subtitle services listed above.
- MIT licensed, with no telemetry and no paid edition.
Browser
│
▼
StreamVault (Rails)
├──► Cinemeta / OMDB metadata, artwork, ratings
├──► Torrentio / Comet / AIOStreams stream providers
├──► RealDebrid / TorBox debrid resolution
└──► Playback
├── direct proxy compatible media, no encoder
└── FFmpeg remux or transcode, subtitle burn-in, HLS
- Search. StreamVault queries metadata catalogues and returns matching titles with posters, ratings, and plots.
- Pick a source. Each title lists available streams with quality, size, and audio languages, sorted by your preferences.
- Press play. StreamVault resolves the source through RealDebrid or TorBox, or follows an AIOStreams link, probes its tracks, and chooses direct play, remux, or transcode.
- Keep watching. Progress is saved as you watch, so the same title resumes on any device you sign in from.
StreamVault does not ship a catalogue and does not keep a media library. Bytes pass through the server on demand and may be buffered while proxied or transcoded.
A debrid path means a RealDebrid account, a TorBox account, or a configured AIOStreams instance. With both debrid keys set, both pools are queried.
| Service | Role | Needed |
|---|---|---|
| RealDebrid | Resolves the selected stream into a direct link | One debrid path |
| TorBox | Alternative debrid resolver, queried alongside RealDebrid | One debrid path |
| OMDB | IMDb, Rotten Tomatoes, and Metacritic ratings | Required, free key |
| Torrentio | Finds available streams | Default provider |
| Comet | Self-hosted alternative stream provider | Optional |
| AIOStreams | Aggregating stream provider over your own sources and debrid services | Optional; can supply its own debrid |
| Cinemeta | Titles, posters, plots, episodes | Built in, no key |
| TMDB | Recommendations from your watch history | Optional, free key |
| SubDL | External subtitles for titles without embedded tracks | Optional, free key |
You need: a Linux server or VPS with Docker and Docker Compose, one debrid path (a RealDebrid or TorBox account, or a configured AIOStreams install), and a free OMDB API key. A 2-core, 2 GB machine is enough for direct play; 4 cores and 4 GB or more keeps transcoding comfortable.
git clone https://github.com/vitobotta/streamvault.git
cd streamvault
cp .env.example .env
openssl rand -hex 64 # SECRET_KEY_BASE
openssl rand -hex 32 # run separately for each encryption key and POSTGRES_PASSWORD
${EDITOR:-nano} .env
docker compose up -d --buildSet at minimum SECRET_KEY_BASE, the three ACTIVE_RECORD_ENCRYPTION_* values, POSTGRES_PASSWORD, and OMDB_API_KEY. Set APP_DOMAIN for a public deployment. The app is then on http://localhost:3000 unless you changed PORT.
Sign-ups are disabled by default. Create the first account from the Rails console:
docker compose exec web bin/rails c
> password = SecureRandom.base58(24)
> User.create!(email: "you@example.com", password: password, password_confirmation: password)
> puts passwordSave the password, sign in, and change it from Settings if you like. To allow self-registration, set ENABLE_SIGNUPS=true and restart.
Then give that account the administrator role, which unlocks the Team page (/admin/settings) where installation-wide debrid keys are set:
docker compose exec web bin/rails "admin:promote[you@example.com]"Without an email it promotes the oldest account. Only administrators can open /admin/settings; everyone else is redirected.
Open Settings and paste a RealDebrid key from real-debrid.com/apitoken or a TorBox key from your TorBox account settings. Save; StreamVault verifies the key immediately. Add both if you have both, and streams from each are merged. Keys are encrypted at rest and never appear in logs.
Using AIOStreams instead? Set STREAM_PROVIDER=aiostreams and AIOSTREAMS_URL in .env, then restart. AIOStreams keeps its own source and debrid configuration, so accounts served by it need no key here.
git pull
docker compose up -d --buildThe database lives in ./data and survives rebuilds. Containers restart on crash and on boot (restart: unless-stopped); make sure Docker itself starts at boot with sudo systemctl enable docker.
If you are upgrading from a build before persisted series totals, backfill the episode totals used by library cards once:
docker compose exec web bin/rails series:backfill_totals| Variable | Purpose | Default |
|---|---|---|
SECRET_KEY_BASE |
Session cookies | required |
ACTIVE_RECORD_ENCRYPTION_* |
Encrypt stored API keys | required |
POSTGRES_PASSWORD |
Database password | required |
OMDB_API_KEY |
Ratings metadata; one of OMDB/TMDB is required for child accounts capped below 18 | required |
APP_DOMAIN |
Public host name | empty |
ENABLE_SIGNUPS |
Allow self-registration | false |
STREAM_PROVIDER |
torrentio, comet, aiostreams, or auto |
torrentio |
TMDB_READ_ACCESS_TOKEN |
Recommendations and the fallback certification source for child accounts | empty |
SUBDL_API_KEY |
External subtitle fallback | empty |
REALDEBRID_API_KEY |
Installation-wide RealDebrid key used when no team key is set | empty |
TORBOX_API_KEY |
Installation-wide TorBox key used when no team key is set | empty |
AIOSTREAMS_URL |
AIOStreams install/manifest URL for the aiostreams provider |
empty |
AIOSTREAMS_PROXY |
Forward proxy for AIOStreams requests | empty |
TORBOX_API_BASE_URL |
TorBox API base URL | https://api.torbox.app/v1/api |
STREAM_SOURCE_HOSTS |
Comma-separated hosts AIOStreams may resolve through | empty |
FFMPEG_ENCODER |
Transcode encoder; auto picks a verified hardware encoder, unset keeps libx264 |
unset |
FORCE_SSL |
Redirect to HTTPS and mark cookies Secure; false for plain HTTP on a trusted network |
true |
ASSUME_SSL |
Trust X-Forwarded-Proto from a TLS-terminating proxy; false when Rails is reached directly |
true |
SOLID_QUEUE_IN_PUMA |
Run jobs inside the web process instead of the worker service |
unset |
JOB_PROCESSES |
Worker processes started by the worker service; each runs three threads |
1 |
HLS_CLEANUP_IN_WEB |
Web process cleans up expired HLS sessions; false disables it |
true |
The full list, provider modes, Cloudflare proxy setups, and reverse proxy notes are in docs/CONFIGURATION.md.
| Symptom | First thing to check |
|---|---|
| No streams, 403s, or intermittent provider failures | Your server IP may be blocked by Cloudflare. See the proxy guide |
| Playback buffers during transcoding | CPU saturation in the web logs. Try a 1080p H.264 source before 4K, HEVC, or AV1 |
| A resumed stream is CPU-heavy | Expected: a non-zero seek may re-encode to keep audio and video aligned |
| Sign-in does not persist behind a proxy | HTTPS on the public URL, and the proxy must forward the original scheme and host |
| Jobs never run, or recommendations stay stale | The worker service is up (docker compose ps, docker compose logs -f worker); the web container does not execute jobs unless SOLID_QUEUE_IN_PUMA is set |
Logs and health:
docker compose ps
docker compose logs --tail=200 -f web worker
curl -I http://localhost:${PORT:-3000}/upMore in docs/CONFIGURATION.md.
StreamVault is one person's work, built in the evenings and at weekends. Sponsorship pays for the time that goes into it:
- Fixes land sooner. Playback bugs, device quirks, and provider changes are worked through in order of impact.
- The app keeps up. RealDebrid, TorBox, Torrentio, Cinemeta, AIOStreams, and the metadata APIs change without warning. Keeping up is ongoing work, not a one-off.
- No lock-in stays possible. MIT license, self-hosted, no account with the author. Sponsorship keeps that sustainable instead of a paid tier.
From $1/month. Sponsoring funds maintenance and development, not content.
Other ways to help, all free: star the repo so other self-hosters find it, report bugs with logs and your setup, answer a question in Discussions, or send a pull request.
I'm Vito Botta, a developer in Finland. I build web applications by day and maintain a few open source projects in the time around it, including hetzner-k3s. StreamVault is what I wanted for my own movie nights: a proper cinema interface, one server, and nothing to babysit.
More at vitobotta.com.
Contributions are welcome. Development setup, the test suites, architecture notes, CI, and the release process are in docs/DEVELOPMENT.md.
The Jellyfin parity backlog, one feature per pull request, is tracked in docs/jellyfin-parity.md.
For a bug report, include your deployment type, the relevant log lines, and what you were playing. For a playback problem, the server log and the browser console together are worth more than either alone.
StreamVault is a general-purpose media client. Like a web browser or a BitTorrent client, it is neutral about what its operator chooses to access. The repository does not include or publish copyrighted media, and it ships no pre-configured list of pirated material.
The author does not endorse, encourage, or support the use of StreamVault to access copyrighted content without proper authorisation. Whoever runs an instance is responsible for what it accesses and for ensuring they have the right to access it. StreamVault is intended for:
- Public domain films and media
- Creative Commons and open-licensed content
- Your own media
- Any other content you are legally entitled to watch
The software is provided as-is, for personal use, with no warranty. The author accepts no responsibility for how an instance is used.
MIT. See LICENSE.

