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.

Invidious logo

Self-host Invidious

v2.20261114.0

Ad-free open-source front-end for YouTube, no JS needed

ReleaseOpen SourceAGPL-3.0
Docker ComposeCompose file & guide
docker compose up -d
Updatedyesterday
LanguageCrystal
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
26 022
RAM
2GB of free RAM
Storage
20GB disk space
Port
3000 (Invidious web UI and API (mapped as 127.0.0.1:3000:3000 behind a reverse proxy in the production compose example))
Requires
Invidious companion
Docker
quay.io/invidious/invidious
Video player pageUser preferences pageSubscriptions feedVideo description viewPreferences page, second sectionSubscriptions feed, second view

What is Invidious?

Invidious is a libre, open-source front-end for YouTube, aimed at people who want videos without ads, without Google tracking and without a Google account, and who may even turn JavaScript off. Channel subscriptions, watch history and playlists live in its own PostgreSQL database, and that data can be imported from or exported to YouTube, NewPipe and FreeTube. Day-to-day capabilities include an audio-only mode with background play, light and dark themes, notifications for subscribed channels, Reddit-sourced comments, embeddable players, SponsorBlock support and a documented REST API; YouTube's official APIs are not used.

Operators self-host it either with Docker Compose, pulling the Quay image next to a PostgreSQL container and Invidious companion (the separate program that fetches video streams from YouTube), or by building from source with Crystal on Linux. macOS and Windows users are pointed at Docker. Settings come from config/config.example.yml, whose path can be overridden with INVIDIOUS_CONFIG_FILE.

Caveats: hosting on PaaS or SaaS platforms is unsupported by the team, the maintainers advise restarting an instance at least daily and ideally every hour, playback of higher fixed resolutions needs DASH and therefore JavaScript, and subtitles often fail on busy instances because of Google rate limiting. There are no packaged binaries and no native phone apps.

Invidious alternatives

All self-hosted alternatives to YouTube →

Should you self-host Invidious?

Invidious scores 80/100 on selfhost.directory (how scoring works) and ranks #1 of 54 in Media Streaming. It has 26 022 GitHub stars, +739 in the last 30 days.

It shipped 9 stable releases in the past year. The latest, v2.20261114.0, came out on 14 November 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Crystal.

Its closest alternative on selfhost.directory is PeerTube (76/100, 15 409 stars). Invidious scores higher overall. See Invidious vs PeerTube side by side.

Features

  • Ad-free video playback
  • Audio-only Mode
  • Channel notifications
  • Customizable Homepage
  • DASH quality selectionNeeds JavaScript and can be disabled by the instance admin; off by default.
  • Data Import/Export
  • Does not use official YouTube APIs
  • Embedded video support
  • Multilingual interface
  • No JavaScript requiredDASH playback needs JavaScript.
  • No TrackingInstance owners can still log your IP address.
  • REST API
  • Subscriptions and playlists without a Google account

Invidious README

How to install Invidious

Install Invidious with Docker Compose

Environment variables
INVIDIOUS_CONFIG

git clone https://github.com/iv-org/invidious.git cd invidious

docker compose up -d

Production method using the pre-built quay image, plus a postgres service and the companion service.

How to configure Invidious

  • port3000Port to listen on for incoming connections.

    values: 1-65535

  • check_tablesfalseAutomatic table integrity check; creates missing tables and columns.

    values: true, false

  • invidious_companion_keyAPI key securing communication with Invidious companion; mandatory when companion is enabled.

    values: a string (of length 16)

  • hmac_keyHMAC signing key for CSRF tokens, cookies and pubsub subscription verification; mandatory, a random string (pwgen 20 1).

    values: a string

  • SERVER_SECRET_KEYEnvironment variable holding the Invidious companion secret key (same value as invidious_companion_key).

    values: 16-character key

Invidious releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Why can't I log in nor save preferences?

Check the domain option: its value is used for the session and preferences cookies, and it must be left empty when you reach the instance by IP address.

Why is the "popular" feed on my instance empty?

That feed is built from videos popular among the users registered on your instance, so it stays empty if nobody has an account (for example when registration is disabled).

RSS feeds and links redirect to <IP>:3000 even though I have a reverse proxy. Why?

Set https_only, domain and external_port to match how the instance is actually served through the proxy.

How can I configure [thing]?

Read the example configuration file config/config.example.yml, which documents every supported option.

Do you provide pre-built binaries (.deb, .rpm, etc.)?

No, because Invidious is a rolling release; you get a fresh clone or pull the latest commits from master.

Where are the 360p/480p/1080p quality options?

Those appear only once DASH is enabled in the preferences, and DASH needs JavaScript, so an instance admin may have it off; by default DASH is disabled to allow JavaScript-free playback and save bandwidth.

Why are subtitles not working?

Captions usually break on popular instances because of Google URL rate limiting; use a less popular instance or host your own.

How do I fix DB::PoolRetryAttemptsExceeded?

Same underlying database problem on that instance; admins should restart Invidious, then PostgreSQL, then raise the maximum connection count.

How do I fix "Could not check out a connection in 2.0 seconds (DB::PoolTimeout)"?

It means the instance has database trouble; no bug report will help, so pick another public instance.

The media could not be loaded — what should I do?

Try enabling Proxy videos or &local=1, refresh the page a few times, switch to DASH quality or another instance; instance admins should read the YouTube error-message guide.

What data is shared with YouTube?

By default video streams come directly from Google's servers, so Google sees your IP and browser details; the Proxy videos preference makes the instance relay the request instead.

What data is collected by Invidious?

Invidious itself collects nothing about users, but instance owners can log IPs and the server logs accessed URLs, status codes and response times. Accounts store watch history and subscriptions.

Can I synchronize my account between instances?

Only manually, by exporting your Invidious data as JSON on one instance and importing it on the other; automatic sync is not implemented for lack of resources.

Do you plan to make an Android/iOS app?

No; it is and always will be a browser application, with NewPipe mentioned for Android.

Can I use Invidious on my device?

Yes, any device with a modern web browser, and the interface is responsive on mobile and tablets.

More in Media Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…