04-07-2026, 03:56 AM
TrueNAS and Proxmox Storage Integration Guide
Overview
This guide explains how to set up TrueNAS as an NFS storage backend and integrate it with Proxmox for VM and container storage.
Environment
Step 1 - Access TrueNAS
Step 2 - Create Storage Pool in TrueNAS
Run on: TrueNAS Server
Navigate to Storage > Pools > Add Pool and follow these steps:
2.1 Set RAID Configuration
2.2 Create Dataset (Optional)
2.3 Add NFS Share
Step 3 - Add TrueNAS NFS Share to Proxmox
Run on: Proxmox Server
3.1 Login to Proxmox
3.2 Add NFS Storage
Step 4 - Test the Setup
Run on: Proxmox Server
Verify NFS exports from Proxmox:
Ping TrueNAS from Proxmox to verify connectivity:
Create a test VM and select TrueNAS-NFS as storage for disks or backups then deploy and start the VM to verify functionality.
Step 5 - Troubleshooting
Run on: TrueNAS Server
If connectivity issues occur restart NFS services on TrueNAS:
Common checks:
Summary
Overview
This guide explains how to set up TrueNAS as an NFS storage backend and integrate it with Proxmox for VM and container storage.
Environment
- TrueNAS Server IP: 172.16.x.x
- Proxmox Node IPs: 172.16.x.21, 172.16.x.22, 172.16.x.23
- Network: 172.16.x.0/24
- Connection: Via VPN (e.g. WireGuard)
Step 1 - Access TrueNAS
- Connect to your VPN first (e.g. WireGuard)
- Open TrueNAS UI in your browser
- Login with your TrueNAS admin credentials
Step 2 - Create Storage Pool in TrueNAS
Run on: TrueNAS Server
Navigate to Storage > Pools > Add Pool and follow these steps:
2.1 Set RAID Configuration
- Use RAIDZ2 for redundancy
- Add all 3.64 TiB x 12 disks under Data
- Set Width to 12 to use all disks in one VDEV
- Confirm configuration and create the pool e.g. ProxmoxPool
2.2 Create Dataset (Optional)
- Select your pool ProxmoxPool
- Add a dataset e.g. ProxmoxStorage for better organization
2.3 Add NFS Share
- Go to Sharing > Unix Shares (NFS) and click Add
- Path: /mnt/ProxmoxPool or dataset path if applicable
- Networks: 172.16.x.0/24
- Hosts: Add specific Proxmox node IPs
- Maproot User/Group: Set both to root
- Save and enable the NFS share
Step 3 - Add TrueNAS NFS Share to Proxmox
Run on: Proxmox Server
3.1 Login to Proxmox
- Open Proxmox UI in your browser e.g. https://your-proxmox-ip:8006
- Login with your Proxmox admin credentials
3.2 Add NFS Storage
- Navigate to Datacenter > Storage > Add > NFS
- ID: TrueNAS-NFS
- Server: 172.16.x.x (TrueNAS IP)
- Export: /mnt/ProxmoxPool
- Content: Select Disk image, ISO, Backup
- Click Add to save
Step 4 - Test the Setup
Run on: Proxmox Server
Verify NFS exports from Proxmox:
Code:
showmount -e TRUENAS_IPPing TrueNAS from Proxmox to verify connectivity:
Code:
ping TRUENAS_IPCreate a test VM and select TrueNAS-NFS as storage for disks or backups then deploy and start the VM to verify functionality.
Step 5 - Troubleshooting
Run on: TrueNAS Server
If connectivity issues occur restart NFS services on TrueNAS:
Code:
service nfs-server restartCommon checks:
- Ensure Proxmox nodes can ping TrueNAS IP
- Verify NFS share is enabled in TrueNAS UI
- Check firewall rules allow NFS traffic on port 2049
- Verify VPN connection is active
Summary
- TrueNAS configured with RAIDZ2 pool using 12 disks
- NFS share created and restricted to Proxmox network
- NFS storage added to Proxmox Datacenter
- Storage available for VM disks, ISOs and backups
- Always test connectivity before deploying production VMs
- Use RAIDZ2 for production environments requiring redundancy

