Invidious Deployment

This repository contains a full Docker-based deployment for Invidious, an open-source alternative front-end to YouTube.

Included Services

• Invidious: The core web application.
• inv-sig-helper: A helper service that helps Invidious bypass YouTube's signature challenges and player throttling.
• PostgreSQL: Database to store user preferences and cached data.
• Caddy: A modern web server that automatically manages SSL (HTTPS) for your domain.

Setup Instructions

1. Configure the .env File: Update the following variables in the .env file:

   • DOMAIN: Your actual domain name (e.g., invidious.example.com).
   • ACME_EMAIL: Your email address for SSL certificate registration.
   • HMAC_KEY: A unique random key (already generated for you).

2. Deploy with Docker Compose: On your VPS, run the following command to start the stack:

   docker compose up -d

3. Check Logs: To monitor the setup process:

   docker compose logs -f

Post-Installation

• Once deployed, visit your domain. The first load may take a moment while the database initializes.
• You can further customize Invidious by editing the INVIDIOUS_CONFIG block in docker-compose.yml or creating a config/config.yml file.

Troubleshooting

• Signature Issues: If videos fail to play, ensure the sig-helper service is running and correctly linked in the docker-compose.yml.
• SSL Issues: Caddy will automatically try to get a certificate from Let's Encrypt. Ensure your domain points to your VPS IP and ports 80/443 are open.