Back to projects
Sep 18, 2024
3 min read

Implementing ZeroTier for TrueNAS Scale System

This project involved configuring ZeroTier on a TrueNAS Scale system to act as a WireGuard client, enabling secure connections to the client's Ubiquity router.

Client Overview:

  • Client: Business Owner
  • Request:
    The client approached my Service seeking assistance in enabling their TrueNAS Scale system as a WireGuard client to establish a connection to their Ubiquity router. The client had explored the available documentation but found it challenging and out of their comfort zone. They requested a solution that could bridge the gap.

The Challenge:

TrueNAS Scale 24.04.0 introduced more restrictive file system structures and permissions, particularly concerning write access and executable file permissions. This made setting up networking solutions like WireGuard a bit more involved. The client required the TrueNAS system to act as a client, connecting back to their Ubiquity router.

The Agreed Solution:

After discussing potential approaches, I proposed using ZeroTier instead of directly configuring WireGuard. ZeroTier offers a reliable, software-based solution that is simpler to set up and maintain in this environment, particularly in the latest TrueNAS version with stricter permissions.

The benefits of using ZeroTier in this case included:

  • Compatibility with TrueNAS Scale: ZeroTier can be implemented with fewer system configuration changes than WireGuard.
  • Simplified Networking Setup: The client could avoid the complexities associated with manually configuring WireGuard.
  • Remote Management: ZeroTier also enabled the client to manage connections from multiple locations.

Implementation Process:

  1. Installing ZeroTier on TrueNAS:

    • TrueNAS 24.04.0 posed some challenges due to its updated permission model, but we navigated these by making necessary adjustments to allow ZeroTier installation.
    • Ensuring that proper executable file permissions were granted during the installation process, which required attention to specific folder paths in the new TrueNAS structure.
  2. ZeroTier Network Configuration:

    • After installation, I configured the TrueNAS system to connect to the client’s ZeroTier network.
    • The system was configured to work as a client, establishing secure communication with the client’s Ubiquity router.
  3. Testing and Validation:

    • Once ZeroTier was fully set up and running, extensive testing was done to ensure the TrueNAS system was securely connecting to the Ubiquity router and behaving as intended.

Results:

The ZeroTier solution allowed the client to seamlessly establish secure connectivity between their TrueNAS Scale system and Ubiquity router, without requiring complex configurations or direct WireGuard setup. The client appreciated the streamlined process and the flexibility ZeroTier provided.


Client Review

Client: Business Owner
Feedback:
“Great to work with. Really heard me out, tested a solution on his end and then deployed it for me. Works great and I would have never considered it.”
Rating: ★★★★★