From 3b2dfba62d970e4612a5e90051f6cb5d1aa1824e Mon Sep 17 00:00:00 2001
From: alex <alex@pdp7.net>
Date: Sat, 1 Apr 2023 16:07:54 +0200
Subject: Document Podman

---
 personal_infra/podman.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 personal_infra/podman.md

(limited to 'personal_infra/podman.md')

diff --git a/personal_infra/podman.md b/personal_infra/podman.md
new file mode 100644
index 00000000..703b6edf
--- /dev/null
+++ b/personal_infra/podman.md
@@ -0,0 +1,26 @@
+# Podman
+
+You can create LXC containers in Proxmox (using ZFS) that can run rootless Podman.
+
+The [`proxmox_create_lxc`](playbooks/roles/proxmox_create_lxc/) role can create the LXC container with the necessary options with the following configuration:
+
+```
+proxmox:
+...
+  privileged: true
+  features: fuse=1,nesting=1
+  extra:
+    - "lxc.mount.entry: /dev/net/tun dev/net/tun none bind,create=file"
+    - "lxc.cgroup2.devices.allow: c 10:200 rwm"
+```
+
+The [`podman`](puppet/modules/podman/) Puppet module can add the necessary configuration:
+
+```
+class {'podman':
+  user => 'your_username',
+  storage_driver => 'zfs',
+}
+```
+
+This module configures subuids/subgids, but until you reboot, you will get some warnings using Podman.
-- 
cgit v1.2.3