//nbkelley /homelab

Proxmox LXC Storage Mounts

Calendar May 1, 2026
Proxmox, Lxc, Storage, Bind-Mounts, Permissions, Jellyfin

Proxmox LXC Storage Mounts#

What Was Established#

  • SMB/CIFS shares can be integrated into Proxmox via CLI or the Web GUI.
  • GUI integration is recommended for Proxmox-native features (backups, ISOs, templates) and automatic retention management.
  • LXC containers can directly mount Proxmox storage paths using mp0/mp1 directives in the container config file.
  • Separate CIFS storages should be used for media vs. backups to maintain clean separation of concerns.

Key Decisions#

  • Storage Content Types: For media-only CIFS shares, select Container templates, ISO images, or Disk image. Explicitly avoid Containers and VZDump backup file to prevent Proxmox from treating the media share as a system storage.
  • Subdirectory Configuration: Leave the Proxmox storage subdirectory field blank to mount the root of the SMB share, enabling flexible navigation to specific subfolders (e.g., Documents/Movies).
  • Jellyfin Path Targeting: Point Jellyfin directly to the specific media subfolder (e.g., /media/synology/Documents/Movies) rather than the mount root.

Current Configuration#

  • LXC Config Path: /etc/pve/lxc/<CT-ID>.conf (e.g., /etc/pve/lxc/100.conf).
  • Mount Syntax: mp0: /mnt/pve/<Storage-ID>,mp=/media/<mount-name>
  • Permission Mapping (for unprivileged containers): 
    lxc.idmap: u 0 100000 65536
lxc.idmap: g 0 100000 65536
lxc.idmap: u 1000 1000 1
lxc.idmap: g 1000 1000 1
lxc.idmap: u 1001 101001 64535
lxc.idmap: g 1001 101001 64535
  • Jellyfin Setup: Dashboard → Libraries → Add Media Library → Folders: /media/synology/Documents/Movies.

Historical Notes#

  • Conversation date: 2025-11-07.
  • Focuses on resolving LXC mount visibility and permission issues for Jellyfin on a Synology NAS.
  • No major infrastructure changes flagged; patterns remain valid for Proxmox 8.x.

Open Questions#

  • None.

Sources#

  • ingested/chats/092-Mount NAS Storage to LXC Containers.md
  • ingested/chats/091-Mount Synology SMB to Proxmox Guide.md
  • ingested/chats/090-Mount SMB Share on Proxmox Guide.md
  • DeepSeek conversation: Mount NAS Storage to LXC Containers (2025-11-07)

Sources#

  • ingested/chats/092-Mount NAS Storage to LXC Containers.md
  • ingested/chats/091-Mount Synology SMB to Proxmox Guide.md
  • ingested/chats/090-Mount SMB Share on Proxmox Guide.md
  • Historical DeepSeek conversation: “Mount SMB Share on Proxmox Guide” (2025-11-07)

Proxmox Storage Management, Proxmox Systemd Mounts