Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions mie-opensource-landing/docs/admins/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,4 @@ sidebar_position: 1
- **[Core Concepts →](core-concepts)** — Cluster organization, user roles, container lifecycle
- **[Deploying LDAP Servers →](ldap-servers)** — Set up ldap1/ldap2 for container authentication
- **[Deploying Agents →](deploying-agents)** — Set up agent containers on remote Proxmox nodes
- **[Kernel Keyring Configuration →](kernel-keyring)** — Fix "disk quota exceeded" errors under nested Docker/LXC virtualization
37 changes: 37 additions & 0 deletions mie-opensource-landing/docs/admins/kernel-keyring.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
sidebar_position: 8
---

# Kernel Keyring Configuration

Configure kernel keyring quotas on Proxmox hosts so the unprivileged UID mapped to `root` inside containers has the same key limits as the real host root, preventing quota exhaustion under nested Docker/LXC virtualization.

## Apply the Settings

Run the following on every Proxmox host node:

```bash
# Increase max number of keys allowed per UID
sysctl -w kernel.keys.maxkeys=200000

# Increase max bytes of kernel memory for keys per UID
sysctl -w kernel.keys.maxbytes=2000000
```

To persist across reboots, add the values to `/etc/sysctl.d/99-kernel-keys.conf`:

```bash
cat >> /etc/sysctl.d/99-kernel-keys.conf << 'EOF'
# Allow unprivileged container root the same keyring limits as host root.
# Prevents "unable to create session key: disk quota exceeded" under nested
# virtualization (e.g. Docker inside LXC).
kernel.keys.maxkeys=200000
kernel.keys.maxbytes=2000000
EOF

sysctl --system
```

:::important
These settings must be applied on every Proxmox node where nested Docker builds or Docker-in-LXC workloads run.
:::
Loading