4 Setup Invidious companion on a separate subdomain server

Émilien (perso) edited this page 2025-09-16 13:05:30 +02:00

Invidious companion can be hosted on any subdomain that you want (not tested on a completely different domain) and thus on a different server.

This allows you to host Invidious on a beefy server that will take all the requests from your users. But use a separate server only for the Invidious companion that has unlimited bandwidth limit but less CPU resources as the main Invidious server.

1. In invidious config, you will need to configure as such:

   invidious_companion:
     - private_url: "https://YOURSEPARATEDOMAIN/companion"
       public_url: "https://YOURSEPARATEDOMAIN/companion"
   

2. In your reverse proxy, you need to add a new route for /companion. NGINX example:

   location /companion {
     proxy_pass http://127.0.0.1:8282;
   }
   

That's it!

You can have as many Invidious companions as you want to. The key invidious_companion in the invidious config is an array.