Proxmox Systemd 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.
• System-level mounts (e.g., at /media/synology) are distinct from Proxmox Storage and are used for general file operations accessible by the host OS.
• Proxmox automatically mounts SMB shares under /mnt/pve/<storage_id> when configured via the GUI.

Key Decisions#

• Maintain both a Proxmox Storage entry (for VM disks/backups) and a system-level mount (for general file access).
• Extract credentials from /etc/pve/storage.cfg to avoid hardcoding passwords in multiple places.
• Use pvesm status to verify existing storage mounts and avoid conflicts.

Current Configuration#

• Synology NAS (LonelyMountain): 192.168.1.137
• Proxmox Storage: Configured via Datacenter > Storage (SMB/CIFS) for VM-related content.
• System Mount: Targeted at /media/synology for general file operations.

System-Level Mount Methods#

1. Extract Credentials & Create System Mount#

1. Check existing Proxmox storage: pvesm status
2. Extract server/share info from /etc/pve/storage.cfg
3. Create credentials file:

   nano /root/.smbcredentials
   # Add: username=your_username, password=your_password
   chmod 600 /root/.smbcredentials

4. Add to /etc/fstab:

   //192.168.1.137/share_name /media/synology cifs credentials=/root/.smbcredentials,uid=0,gid=0,file_mode=0660,dir_mode=0770,iocharset=utf8 0 0

5. Test: mount -a

2. Systemd Mount Unit (Recommended for robustness)#

Create /etc/systemd/system/media-synology.mount:

[Unit]
Description=Mount Synology SMB Share
Before=local-fs.target

[Mount]
What=//192.168.1.137/share_name
Where=/media/synology
Type=cifs
Options=credentials=/root/.smbcredentials,uid=0,gid=0,file_mode=0660,dir_mode=0770,iocharset=utf8,_netdev

[Install]
WantedBy=multi-user.target

Enable and start:

systemctl daemon-reload
systemctl enable media-synology.mount
systemctl start media-synology.mount

Troubleshooting#

• Mount error(112): Share already mounted by Proxmox. Check with mount | grep cifs. Proxmox typically mounts to /mnt/pve/<storage_id>. Create a symlink if needed: ln -s /mnt/pve/<storage_id> /media/synology.
• Connection refused: Verify Synology SMB service is running and network connectivity.
• Permission denied: Verify credentials and share permissions. Use smbclient -L //192.168.1.137 -U username to test SMB access.
• Disable Proxmox storage temporarily: pvesm set <storage_id> --disable 1 if conflicts arise.

Historical Notes#

• Crystallized from 2025-11-07 conversation regarding mounting Synology SMB to Proxmox.
• Distinguishes between Proxmox-managed storage (Datacenter > Storage) and host-level system mounts.

Related Pages#

Proxmox Storage Management, Proxmox LXC Storage Mounts

Sources#

Split from Proxmox Storage Management.