🚀 Getting Started

Installing Virtlix on a Fresh Server Server Requirements & Partition Layout Activating Your License Your First VPS

🖥️ VPS Management

Creating and Configuring a VPS Cloning and Rebuilding a VPS Creating a Reusable Template from a VPS Resource Plans and Per-VM Limits Windows Guest Support Rescue Mode: Recovering a Broken VPS

📦 LXC Containers

LXC Containers: What They Are and When to Use Them Creating and Managing an LXC Container LXC Container Limitations vs KVM

🌐 Networking & Firewall

IP Pool and Network Modes VPS Firewall Rules Server-Level Firewall Plans Console Access: noVNC and the Web Terminal Network Filtering: Anti-Spoofing and Rogue RA Protection IPv6 Dual-Stack Networking Power DNS Integration and Reverse DNS Zones Adding Multiple IPs and Per-IP MAC Overrides

💽 Storage & Hardware

Storage Pools: Local Disk and Remote NFS PCI and USB Device Passthrough Attaching Extra Volumes to a VPS

💾 Backups & OS Templates

Automated Backups and Backup Destinations Managing OS Templates Uploading and Using ISOs Media Groups

🔑 Multi-Server & Licensing

Understanding Your License and VPS Limits Master Configuration and Security Settings Registering and Controlling Remote Servers Webhook Callbacks Selling VPS Hosting Through WHMCS

🔐 Account & Security

Two-Factor Authentication

❓ Troubleshooting & FAQ

Console Shows "Connection Lost" License Shows as Suspended or Expired VPS Won't Start After Creation Common Questions Can't SSH Into a New LXC Container PCI Passthrough Device Not Working NFS Storage Pool Won't Mount OS Template Download Stuck or Failed

Docs / Troubleshooting & FAQ / NFS Storage Pool Won't Mount

NFS Storage Pool Won't Mount

Since the panel's own web process doesn't run as root, mounting a Remote Filesystem (NFS) storage pool goes through a narrowly-scoped privileged helper rather than a direct mount call from PHP. If a new NFS pool won't mount, check these in order:

1. Is the export actually reachable? From the host itself: showmount -e <nfs-server-ip> should list the export path you configured. If this fails or times out, it's a network/firewall issue between the Virtlix host and the NFS server, not a Virtlix configuration problem - check the NFS server's own export permissions (/etc/exports) actually allow this host's IP.

2. Try mounting it manually to isolate whether the problem is the mount itself or something Virtlix-specific:

mount -t nfs <nfs-server-ip>:/export/path /mnt/test

If this fails with a permission or "access denied" error, fix the export's permissions on the NFS server side (matching this host's IP or subnet) before troubleshooting anything in the panel further.

3. Check the mount actually persisted - Virtlix keeps NFS pools mounted across reboots via a systemd mount unit rather than a one-time mount call. If it mounted successfully once but shows as unmounted after a host reboot, check systemctl status for the relevant .mount unit and its own logs for why it didn't come back up automatically.