From 330680842724eb3ae3fcd97499c178d05f46b5a3 Mon Sep 17 00:00:00 2001 From: Programmer001 <39063786+SimplyProgrammer@users.noreply.github.com> Date: Sat, 28 Feb 2026 20:28:55 +0100 Subject: [PATCH 1/3] Add Proxmox setup guide for Invidious Added a section for Proxmox VMs and LXCs with setup instructions. --- docs/community-installation-guide.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/community-installation-guide.md b/docs/community-installation-guide.md index 1ab587d7..9007dda0 100644 --- a/docs/community-installation-guide.md +++ b/docs/community-installation-guide.md @@ -294,6 +294,15 @@ And the whole application can be now started: Keep in mind that generated units cannot be enabled using `systemctl --user enable`. The Invidious containers will be started automatically. +## Proxmox VMs and LXCs + +Guide contributor(s): [@SimplyProgrammer](https://github.com/SimplyProgrammer) + +This method provides a simple and straightforward guide with scripts to setup Invidious inside a Proxmox Linux VM or LXC container. +It utilizes podman to create Invidious containers and Caddy 2 for https reverse proxy. + +Available at https://github.com/SimplyProgrammer/Invidious-podman-LXC-VM + ## MacOS Looking for contributors to this operating system. Please submit a new doc for MacOS at https://github.com/iv-org/documentation/blob/master/docs/community-installation-guide.md From ffbf70d3b04291783e1fbca04a8f9b8529c51ff1 Mon Sep 17 00:00:00 2001 From: Programmer001 <39063786+SimplyProgrammer@users.noreply.github.com> Date: Sat, 28 Feb 2026 21:09:27 +0100 Subject: [PATCH 2/3] Enhance community installation guide details Updated the installation guide to include details about self-signed HTTPS reverse proxy and Linux service for automatic startup. --- docs/community-installation-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-installation-guide.md b/docs/community-installation-guide.md index 9007dda0..5276e6b0 100644 --- a/docs/community-installation-guide.md +++ b/docs/community-installation-guide.md @@ -299,7 +299,7 @@ Keep in mind that generated units cannot be enabled using `systemctl --user enab Guide contributor(s): [@SimplyProgrammer](https://github.com/SimplyProgrammer) This method provides a simple and straightforward guide with scripts to setup Invidious inside a Proxmox Linux VM or LXC container. -It utilizes podman to create Invidious containers and Caddy 2 for https reverse proxy. +It utilizes podman to create Invidious containers, Caddy 2 for self-signed https reverse proxy and Linux service for automatic startup. Available at https://github.com/SimplyProgrammer/Invidious-podman-LXC-VM From c47dadf0f0eb4d21a2a9aa135cb0b9ade058e7a9 Mon Sep 17 00:00:00 2001 From: Programmer001 <39063786+SimplyProgrammer@users.noreply.github.com> Date: Wed, 4 Mar 2026 17:58:59 +0100 Subject: [PATCH 3/3] Update community installation guide with new sections Added prerequisites and installation instructions for Invidious setup in Proxmox. --- docs/community-installation-guide.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/docs/community-installation-guide.md b/docs/community-installation-guide.md index 5276e6b0..1aecc37b 100644 --- a/docs/community-installation-guide.md +++ b/docs/community-installation-guide.md @@ -301,7 +301,32 @@ Guide contributor(s): [@SimplyProgrammer](https://github.com/SimplyProgrammer) This method provides a simple and straightforward guide with scripts to setup Invidious inside a Proxmox Linux VM or LXC container. It utilizes podman to create Invidious containers, Caddy 2 for self-signed https reverse proxy and Linux service for automatic startup. -Available at https://github.com/SimplyProgrammer/Invidious-podman-LXC-VM +### Prerequirements +Debian 12+ VM or an unprivileged Debian 12+ LXC container with: +* Name "invidious" (or something similar) +* 4GB+ of RAM +* 2+ x86_64 cores, 4 is ideal (ARM is also possible but `compose.yml` has to be modified accordingly). +* 20+GB of storage +* Static IP or static DHCP lease on your router. + +### Networking +Further, you will need a DNS domain, paid or local one to point to this IP of your LXC/VM with Invidious. +It would be great if your router would allow/do this by default, and automatically assign something like `invidious.lan` or even better, `invidious.home.arpa` to your LXC/VM. For example, [OpenWrt](https://forum.openwrt.org/t/use-home-arpa-as-default-tld-for-local-network/165056/11) does this by default. For other routers, extra config might be needed. +If you have your own domain, reversed-proxy etc., setup might differ for you... + +### Installation +Run this script (with sudo privileges or as root): +``` +mkdir -p ~/invidious-podman && cd "$_" && git clone "https://github.com/SimplyProgrammer/Invidious-podman-LXC-VM.git" . && chmod 755 setup-invidious.sh && ./setup-invidious.sh +``` +When it asks for the Invidious git repo, for 90% of you just press enter (unless you have your own forked one). + +The most important part, when it asks for the DNS domain, specify aforementioned `invidious.lan`, `invidious.home.arpa` or whatever you have. But make sure the domain is reachable and working in advance (`nslookup` etc.). + +If everything was done properly, now you should have a working LXC/VM with Invidious service and should be able to open it at `https:///`.\ +It should automatically start with your VM/LXC, no extra work needed. + +More info and the whole solution is available for review at https://github.com/SimplyProgrammer/Invidious-podman-LXC-VM. ## MacOS