Agent Modules
Tunely agent modules are different packages of the same core function: a local agent opens an outbound connection to Tunely, receives the assigned services, and reaches the internal target addresses.
Choose a Module
| Module | Best for | Documentation status |
|---|---|---|
| Docker | Homelab hosts, servers, NAS devices with Docker or Compose | Primary generic installation path. |
| Home Assistant Add-on | Home Assistant OS and Supervisor-based installations | Dedicated add-on path. |
| Synology | Synology NAS with Container Manager | Platform guide for DSM Container Manager. |
| Future packages | Specific NAS, appliance, or platform packages | Added when a stable installation path exists. |
Shared Properties
- The agent needs a token from the dashboard.
- The agent stores local runtime data persistently.
- The agent needs outbound connectivity to Tunely.
- The agent must reach the internal target services on the local network.
- Services are configured in the dashboard, not in the agent command.
Decision Guide
Use Docker if you already run containers or want direct control over volumes, updates, and networks. Use the Home Assistant Add-on when Tunely should run inside a Home Assistant environment. For Synology NAS systems, use Container Manager so installation, logs, restarts, and updates stay in the DSM UI.