Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
An alternative front end for YouTube: search, watch, subscribe and build playlists without ads, tracking or required JavaScript, and without a Google account. It offers audio-only mode, comments, a documented API, and import of subscriptions from YouTube, NewPipe and FreeTube, import of watch history from YouTube and NewPipe, and export of subscriptions to NewPipe and FreeTube. Video streams are fetched from YouTube by a separate Invidious companion service, and subscriptions, preferences and playlists are stored in PostgreSQL.
Runs on a VPS from $12/mo (Kamatera 4GB, 4 GB RAM) · prices checked Nov 2026
Fits home hardware (430 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick Invidious when you want an ad-free, tracking-free front end for YouTube that you control, with local accounts for subscriptions and playlists, and you accept that it depends on YouTube letting your server fetch video. It is AGPL-3.0 licensed Crystal code with PostgreSQL storage. The README lists no ads, no tracking, no required JavaScript, audio-only mode, comments, a developer API, and import of subscriptions from YouTube, NewPipe and FreeTube, and export to NewPipe and FreeTube. Since upstream's current installation guide, video streams come from a separate Invidious companion container, so the snippet runs three services as in the guide's production Compose file. It pins `quay.io/invidious/invidious:2.20261103.0`, the quay tag for the release published 2026-11-03 (the release tag points at commit 619529a, and the dated tag 2026.11.03-44f4604 is the later "Prepare for next release" commit), and `postgres:14.24`. The companion has no versioned releases, only a rolling `release-master` and dated image tags plus `latest`, so we pin `2026.11.07-07ae73c` together with its image digest. Generated keys replace the guide's `CHANGE_ME!!` values, and the port is opened instead of bound to localhost, as the guide's note says to do for direct access. The guide states at least 2 GB of free RAM and 20 GB of disk for Invidious plus companion, which is our 2048 MB floor. In this catalog, Tube Archivist downloads videos with yt-dlp and indexes them in Elasticsearch, while PeerTube and MediaCMS host videos you upload; Invidious hosts none and reads from YouTube on demand.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Invidious - privacy-friendly YouTube front end - adapted from docs.invidious.io/installation (production Docker Compose with Invidious companion; generated keys, pinned images, port opened for direct access), pinned to 2.20261103.0
git clone --depth 1 --branch v2.20261103.0 https://github.com/iv-org/invidious.git
cd invidious
echo "HMAC_KEY=$(openssl rand -hex 16)" > .env
echo "COMPANION_KEY=$(openssl rand -hex 8)" >> .env
echo "DB_PASSWORD=$(openssl rand -hex 16)" >> .env
cat > docker-compose.yml <<'EOF'
services:
invidious:
image: quay.io/invidious/invidious:2.20261103.0
restart: unless-stopped
ports:
- "3000:3000"
environment:
INVIDIOUS_CONFIG: |
db:
dbname: invidious
user: kemal
password: ${DB_PASSWORD}
host: invidious-db
port: 5432
check_tables: true
invidious_companion:
- private_url: "http://companion:8282/companion"
invidious_companion_key: "${COMPANION_KEY}"
hmac_key: "${HMAC_KEY}"
healthcheck:
test: wget -nv --tries=1 --spider http://127.0.0.1:3000/api/v1/stats || exit 1
interval: 30s
timeout: 5s
retries: 2
depends_on:
invidious-db:
condition: service_healthy
companion:
condition: service_started
companion:
image: quay.io/invidious/invidious-companion:2026.11.07-07ae73c@sha256:292d889ff6d4cb31970cd35ea9eea8b249dc8c1dc3c66b3ad1b9c4fd0ffb62d1
environment:
- SERVER_SECRET_KEY=${COMPANION_KEY}
restart: unless-stopped
cap_drop:
- ALL
read_only: true
volumes:
- companioncache:/var/tmp/youtubei.js:rw
security_opt:
- no-new-privileges:true
invidious-db:
image: docker.io/library/postgres:14.24
restart: unless-stopped
volumes:
- postgresdata:/var/lib/postgresql/data
- ./config/sql:/config/sql
- ./docker/init-invidious-db.sh:/docker-entrypoint-initdb.d/init-invidious-db.sh
environment:
POSTGRES_DB: invidious
POSTGRES_USER: kemal
POSTGRES_PASSWORD: ${DB_PASSWORD}
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
interval: 5s
timeout: 5s
retries: 20
volumes:
postgresdata:
companioncache:
EOF
docker compose up -d
timeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:3000/api/v1/stats; do sleep 3; done'
# → http://SERVER_IP:3000 (the interface works without a domain; whether videos play depends on YouTube accepting your server's IP, and anyone who reaches the port can register an account)Invidious's installation guide and its YouTube error documentation flag these before you rely on it:
Invidious used 430 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 2048 MB.
The Invidious install snippet is marked verified on Ubuntu 26.04 (Nov 2026).