Storage Reference¶
This document covers all storage systems in the Proxmox cluster.
Overview¶
| Storage | Type | Host | Path | Capacity | Purpose |
|---|---|---|---|---|---|
| local-lvm | LVM-thin | All nodes | - | Varies | VM boot disks |
| px3-nas | NFS/SMB | px3 | /mnt/nas-storage | 1.8 TB | Shared file storage |
| pikvm-backup | NFS | pikvm | /mnt/external | 2.7 TB | Legacy offsite backups |
| pbs-fr | PBS | CT 5101 | 10.35.1.101 | ~1.1 TB | Primary off-site (incremental) |
px3-nas (Local NAS)¶
A 1.8TB local disk on px3 shared via NFS and SMB to the cluster.
Hardware¶
- Host: px3 (REDACTED_IP)
⚠️ Temporary Setup (since 2026-02-07)¶
The NAS drive (WDC WD20EADS) was removed due to Ceph I/O contention. NAS is temporarily served from a USB drive (sdd) while a Samsung 870 EVO 2TB SSD replacement ships. Performance: ~72 MB/s (USB 3.0). See px3 Hardware for details.
Hardware¶
- Host: px3 (10.44.1.30)
- Disk: /dev/sdd2 (ext4, temporary USB — SSD replacement on order)
- Mount point: /mnt/nas-storage
- Capacity: 1.8 TB
Access Methods¶
NFS (Proxmox Storage)¶
The NAS is registered as Proxmox storage px3-nas for VM images, ISOs, backups, and templates.
# Check status
pvesm status | grep px3-nas
# Mount point on nodes
ls /mnt/pve/px3-nas/
Proxmox storage.cfg entry:
nfs: px3-nas
server REDACTED_IP
export /mnt/nas-storage
content images,iso,backup,vztmpl
options vers=4
SMB (Windows/Client Access)¶
For Windows VMs and workstations, connect via SMB:
| Setting | Value |
|---|---|
| Share path | \\REDACTED_IP\storage |
| Username | nasuser |
| Password | REDACTED_PASSWORD |
Windows command:
net use Z: \\REDACTED_IP\storage /user:nasuser REDACTED_PASSWORD
Guest Access
Guest access is configured but Windows 10/11 blocks insecure guest auth by default. Use the nasuser credentials or enable guest auth in Windows:
```powershell
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters" -Name "AllowInsecureGuestAuth" -Value 1
NFS (macOS)¶
macOS can mount NFS shares directly. Create a mount directory and mount the NFS export:
# Create mount point
mkdir -p ~/Storage/nas
# Mount NFS share
mount_nfs -o vers=3 REDACTED_IP:/mnt/nas-storage ~/Storage/nas
# Verify mount
mount | grep nas-storage
To unmount:
umount ~/Storage/nas
SMB (macOS)¶
For SMB access on macOS, use Finder or mount via command line:
Finder method:
1. Press Cmd + K to open "Connect to Server"
2. Enter: smb://nasuser@REDACTED_IP/storage
3. Click "Connect"
4. Enter password: REDACTED_PASSWORD
Command line method:
# Create mount point
mkdir -p ~/Storage/nas
# Mount SMB share
mount_smbfs -o soft nasuser@REDACTED_IP/storage ~/Storage/nas
# Verify mount
mount | grep storage
To unmount:
umount ~/Storage/nas
NFS vs SMB on macOS
- NFS: Better performance for large file transfers, native support
- SMB: Better compatibility with Windows, easier permissions handling Choose based on your workflow needs.
Server Configuration¶
NFS exports (/etc/exports on px3):
/mnt/nas-storage REDACTED_SUBNET(rw,sync,no_subtree_check,no_root_squash,insecure)
/mnt/nas-storage REDACTED_SUBNET(rw,sync,no_subtree_check,no_root_squash,insecure)
SMB config (/etc/samba/smb.conf on px3):
[storage]
path = /mnt/nas-storage
browseable = no
read only = no
guest ok = yes
create mask = 0775
directory mask = 0775
force user = nobody
force group = nogroup
Directory Structure¶
/mnt/nas-storage/
├── dump/ # Backup files
├── images/ # VM disk images (Proxmox)
├── snippets/ # Proxmox snippets
├── synced/ # User shared files
└── template/ # VM templates
Troubleshooting¶
Check NFS server status on px3:
ssh px3 'systemctl status nfs-server'
ssh px3 'exportfs -v'
Check SMB server status on px3:
ssh px3 'systemctl status smbd'
ssh px3 'smbstatus'
Test connectivity from another node:
showmount -e REDACTED_IP
smbclient -L //REDACTED_IP -U nasuser
pikvm-backup (Offsite)¶
Remote NFS storage on pikvm for offsite backups.
| Setting | Value |
|---|---|
| Server | REDACTED_IP (pikvm) |
| Export | /mnt/external |
| Mount | /mnt/pve/pikvm-backup |
| Capacity | 2.7 TB |
| Content | backup, vztmpl |
Warning
This is offsite backup storage only. Do not use for primary VM storage.