Add Proxmox LXC docs #35

Merged
rogs merged 3 commits from add-proxmox-lxc-docs into master 2025-03-30 09:35:14 -03:00
12 changed files with 60 additions and 12 deletions

View File

@ -2,7 +2,7 @@
title: "Adding your own containers to YAMS"
date: 2023-10-21T21:41:29-03:00
draft: false
weight: 1
weight: 2
summary: A complete guide to expanding YAMS with your own Docker containers
---

View File

@ -2,7 +2,7 @@
title: "Backups"
date: 2023-01-17T19:38:39-03:00
draft: false
weight: 6
weight: 7
summary: Everything you need to know about backing up and restoring your YAMS setup
---

View File

@ -2,7 +2,7 @@
title: "Lidarr"
date: 2023-01-31T11:20:14-03:00
draft: false
weight: 8
weight: 9
summary: Lidarr is a music collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new albums from your favorite artists and will interface with clients and indexers to grab, sort, and rename them. It can also be configured to automatically upgrade the quality of existing files in the library when a better quality format becomes available.
---

View File

@ -2,7 +2,7 @@
title: "Port Forwarding"
date: 2024-12-30T10:14:29-03:00
draft: false
weight: 3
weight: 4
summary: Everything you need to know about configuring and using a VPN with YAMS
---

View File

@ -2,7 +2,7 @@
title: "Portainer"
date: 2023-01-30T15:46:05-03:00
draft: false
weight: 7
weight: 8
summary: Your visual control center for all YAMS containers
---

View File

@ -2,7 +2,7 @@
title: "Running Prowlarr Behind the VPN"
date: 2024-09-27T16:44:00-03:00
draft: false
weight: 4
weight: 5
summary: A complete guide to routing Prowlarr's traffic through your VPN for extra privacy
---

View File

@ -0,0 +1,46 @@
---
title: "Proxmox LXC Prerequisites"
date: 2025-03-29T10:00:00-03:00
draft: false
weight: 1
summary: Required steps before installing YAMS in a Proxmox LXC container.
---
# Prerequisites for Installing YAMS in a Proxmox LXC
If you plan to install YAMS inside a Proxmox LXC container, some specific host-level configuration is required **before** you run the YAMS installation script. These steps ensure Docker and the VPN component (Gluetun) can function correctly within the LXC environment by providing access to the necessary TUN device.
> **Note:** This guide is based on the solution discovered and shared by forum user **Bobs_Manager**. You can find the original discussion [here on the YAMS Forum](https://forum.yams.media/viewtopic.php?t=212).
⚠️ **Important:** Only use an **unprivileged** LXC container for YAMS. Privileged containers pose significant security risks and are not recommended.
Follow these steps on your Proxmox **host** system:
1. **Access the Proxmox Host Shell:** Log into your Proxmox server via SSH or use the web UI's shell access for the node (not the LXC console).
2. **Edit the LXC Configuration File:** Open the configuration file specific to the LXC container where you intend to install YAMS. Replace `<container-ID>` with the actual numeric ID of your LXC container.
```bash
nano /etc/pve/lxc/<container-ID>.conf
```
3. **Add Configuration Lines:** Append the following lines to the **end** of the file. These lines grant the container necessary permissions and crucially mount the `/dev/net/tun` device from the host into the container.
```ini
lxc.cgroup.devices.allow: a
lxc.cap.drop:
lxc.cgroup2.devices.allow: c 10:200 rwm
lxc.mount.entry: /dev/net/tun dev/net/tun none bind,create=file
```
Your configuration file should now look similar to this at the end:
[![Proxmox LXC Config Example](/pics/proxmox-lxc-config.png)](/pics/proxmox-lxc-config.png)
4. **Save and Close:** Save the changes to the configuration file and exit the editor.
5. **Restart the LXC Container:** For the changes to take effect, you must restart the LXC container. You can do this via the Proxmox web UI or using the following commands on the Proxmox host:
```bash
pct stop <container-ID>
pct start <container-ID>
```
## Next Steps
After completing these prerequisites and restarting the LXC container, you can now log into the LXC container's console and proceed with the standard YAMS installation as described in the [Installation Guide](/install/steps/).

View File

@ -2,7 +2,7 @@
title: "Readarr"
date: 2023-01-31T13:52:34-03:00
draft: false
weight: 9
weight: 10
summary: Readarr is a ebook collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new books from your favorite authors and will interface with clients and indexers to grab, sort, and rename them.
---

View File

@ -2,7 +2,7 @@
title: "Torrenting"
date: 2023-01-16T14:48:14-03:00
draft: false
weight: 5
weight: 6
summary: Everything you need to know about safe and effective torrenting with YAMS
---

View File

@ -2,7 +2,7 @@
title: "VPN"
date: 2023-01-15T21:16:29-03:00
draft: false
weight: 2
weight: 3
summary: Everything you need to know about configuring and using a VPN with YAMS
---

View File

@ -9,7 +9,7 @@ summary: First steps to install YAMS on your server
YAMS only needs a few things to get started:
- Debian 12 (recommended) or Ubuntu 24.04. If your OS isn't ready yet, check out these guides:
- Debian 12 (recommended) or Ubuntu 24.04 running on bare metal, a VM, or certain container types. If your OS isn't ready yet, check out these guides:
+ https://www.digitalocean.com/community/tutorials/initial-server-setup-with-debian-11 (this tutorial is for Debian 11, but it should be the same).
+ https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-22-04 (this tutorial is for Ubuntu 22.04, but is should be the same).
- Your OS needs to be properly configured. That means:
@ -20,9 +20,11 @@ YAMS only needs a few things to get started:
$ which docker
/snap/bin/docker
```
You **won't** be able to install YAMS. ⚠️
You **won't** be able to install YAMS. ⚠️
Don't worry if you don't have `docker` and `docker-compose` installed - the script can handle that for you on Debian and Ubuntu!
- **Proxmox LXC Users:** YAMS can be installed within an unprivileged Proxmox LXC container, but this requires specific configuration on the Proxmox host **before** you run the YAMS installation script inside the container. Please follow the steps in our [Proxmox LXC Prerequisites guide](/advanced/proxmox-lxc-prerequisites/) before proceeding with the installation steps below.
Don't worry if you don't have `docker` and `docker-compose` installed - the script can handle that for you on Debian and Ubuntu!
## Before running

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB