Summary
Container Station repeatedly displayed “Failed to Change Container Folder” whenever I attempted to select a custom directory for container storage. Even after recreating the folder, fixing permissions, rebuilding ZFS datasets, and reinstalling Container Station, the error persisted.
Root Cause
QuTS hero enforces strict validation rules for Container Station storage paths:
-
The folder must be a QTS Shared Folder, not a manually created directory under
/share. -
The name “Container” is reserved and cannot be used for shared folders or datasets.
-
Manually created ZFS datasets (via CLI) are not registered in QTS’s internal configuration, so Container Station rejects them.
-
Container Station will only accept folders created through Control Panel → Shared Folders.
Resolution
-
Created a new shared folder through the GUI using a non‑reserved name (
ContainerData). -
Selected this shared folder directly in Container Station’s storage settings.
-
Container Station immediately accepted the folder once it was a properly registered shared folder.
2. QVPN UPnP Port Forwarding Errors (PPTP, OpenVPN, QBelt)
Summary
UPnP status showed mixed results: TCP services forwarded correctly, but several VPN services (PPTP, OpenVPN, QBelt) consistently failed UPnP port mapping. Only L2TP/IPSec succeeded.
Root Cause
The pattern revealed:
-
UDP ports were failing, while TCP ports succeeded.
-
QBelt was using UDP 443, a port often blocked or reserved by routers/ISPs.
-
Some routers do not support UPnP for UDP mappings.
-
Possible double NAT or ISP restrictions on low‑numbered UDP ports.
Resolution
-
Changed QBelt to a high, clean UDP port (
60000), which avoids router and ISP filtering. -
Manually forwarded the port on the router (
UDP 60000 → NAS_IP). -
Restarted QVPN service.
-
QBelt and other VPN services began functioning normally after switching to a high‑range UDP port.
3. ZFS Dataset Behavior on QuTS hero
Summary
Manually created ZFS datasets mounted correctly but were not recognized by QTS services such as Container Station.
Root Cause
QuTS hero requires datasets to be created as Shared Folders through the GUI so they are:
-
registered in QTS configuration
-
assigned proper ACLs
-
visible to system services
-
validated by Container Station
CLI‑created datasets bypass these registration steps.
Resolution
-
Recreated the dataset as a Shared Folder through the GUI.
-
Allowed QTS to manage mountpoints, ACLs, and metadata.
-
All dependent services (Container Station, QVPN) recognized the folder correctly afterward.