Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add physical integration guide #237

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

aaronjohnson
Copy link
Contributor

Add documentation for connecting non-ZeroTier devices to ZeroTier networks

This PR adds comprehensive documentation on connecting devices that cannot run ZeroTier directly (such as Synology NAS with DSM 7.x+) to ZeroTier networks through physical network integration. The guide provides detailed instructions for both Layer 2 (bridging) and Layer 3 (routing) approaches, with specific examples for NAS devices and other common scenarios. It also updates the existing Synology documentation to reference this approach as the recommended solution for newer DSM versions where Docker isn't available.

Key additions:

  • Implementation guides for both routing and bridging approaches
  • Hardware selection recommendations
  • Device-specific configuration examples
  • Security and troubleshooting sections
  • Updated references in existing Synology documentation

This documentation addresses a significant user need by providing clear instructions for integrating devices with restricted OSes into ZeroTier networks.

This PR adds documentation for installing ZeroTier directly on Synology NAS
devices without Docker. This method is particularly valuable for ARM64-based
Synology models where Docker (Container Manager) cannot be installed.

- Added comprehensive instructions for compiling and installing ZeroTier
- Updated sidebar to include the new documentation
- Added reference in existing Synology doc to the direct install method
- Includes version-agnostic installation approach for future-proofing
- Added compliance statement regarding human-in-the-loop review
This PR adds comprehensive documentation for connecting devices that cannot run ZeroTier directly (like Synology NAS with DSM 7.x+) to ZeroTier networks through physical network integration. This approach is the recommended solution for devices where direct installation is not possible due to OS restrictions.

This documentation was created in response to Synology's restrictions in DSM 7.x+ that prevent direct installation of ZeroTier due to removal of root access.
@laduke
Copy link
Contributor

laduke commented Mar 7, 2025

We have a similar doc here https://docs.zerotier.com/integrating-physical-networks

@glimberg
Copy link
Contributor

glimberg commented Mar 7, 2025

Given the link that @laduke posted above that already exists in the docs site, I think that makes this change pretty redundant

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants