jarvis/homeassistant-addon-dnclient
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
3 commits 1 branch 0 tags 40 KiB
Shell 79.4%
Dockerfile 20.6%
Find a file
Jarvis ad62d56915 Multi-stage build: extract dnclient binary to avoid VOLUME, symlink /etc/defined -> /data/defined
2026-02-19 07:36:07 +00:00
dnclient Multi-stage build: extract dnclient binary to avoid VOLUME, symlink /etc/defined -> /data/defined 2026-02-19 07:36:07 +00:00
README.md Initial commit: DNClient Home Assistant add-on 2026-02-19 07:22:25 +00:00
repository.json Initial commit: DNClient Home Assistant add-on 2026-02-19 07:22:25 +00:00

README.md

Home Assistant Add-on: DNClient (Defined Networking)

Run Defined Networking's DNClient (Managed Nebula) as a Home Assistant add-on to provide overlay network connectivity to your Home Assistant OS instance.

Installation

  1. In Home Assistant, go to Settings → Add-ons → Add-on Store
  2. Click the ⋮ menu (top right) → Repositories
  3. Add this repository URL: https://github.com/johnmaguire/homeassistant-addon-dnclient
  4. Find DNClient in the store and click Install

Configuration

Option Description
enrollment_code Your enrollment code from the Defined Networking Admin Panel. Only needed for first run.

First Run

  1. Generate an enrollment code from admin.defined.net
  2. Paste it into the add-on configuration
  3. Start the add-on
  4. Once enrolled, you can clear the enrollment code — the host identity is persisted

How It Works

The add-on runs dnclient with host networking and NET_ADMIN capability so it can create the Nebula tun interface directly on the Home Assistant host. Configuration is persisted in the add-on's data directory, so the host only needs to enroll once.

Supported Architectures

  • amd64
  • aarch64