Home Assistant Add-on Repository: MynetworK

MynetworK

Unified Freebox + UniFi management in Home Assistant.

---

_{Powered by}
  

A multi-source network dashboard for Freebox, UniFi support and Network Scanner devices your entires networks as a Home Assistant add-on (Ingress).

Quick Start | Features | Installation | Configuration | Documentation | Documentation FR

---

About

This repository contains the MynetworK app (add-on) for Home Assistant.

MynetworK is the main project — multi-source network dashboard (Freebox, UniFi, network scan). HA_mynetwork is the Home Assistant add-on that embeds it.

Versions (two different version numbers)

	Version	Description
HA_mynetwork (add-on)	0.1.25	Version of this repo (Home Assistant add-on). Bump with scripts/update-version.sh.
MynetworK (main project)	v0.7.45	Version of the embedded app. Source of truth: MynetworK. Must stay up to date when you bump the add-on — update-version.sh fetches the latest from upstream and updates READMEs.

This add-on runs MynetworK inside Home Assistant with Ingress and exposed port, no sensors; the UI is available from the sidebar panel.

---

Quick Start

1. Click the button above
2. Click ADD and RESTART Home Assistant (if prompted)
3. Go to Settings → Apps (or Add-on Store)
4. Search for "MynetworK"
5. Click Install, then Start
6. Open MynetworK from the sidebar (Ingress panel)

---

Repository Structure

HA_mynetwork/
├── repository.yaml              # Repository metadata
├── README.md                    # This file
├── scripts/
│   └── update-version.sh       # Bump version across the repo before push
└── mynetwork/                   # MynetworK add-on
    ├── config.yaml
    ├── Dockerfile
    ├── run.sh
    ├── apparmor.txt
    ├── build.yaml
    ├── CHANGELOG.md             # Changelog (visible in HA app)
    ├── DOCS.md
    ├── DOCS_FR.md
    ├── README.md
    ├── icon.png
    └── translations/
        ├── en.yaml
        └── fr.yaml

For detailed add-on documentation, see mynetwork/DOCS.md | DOCS_FR.md and mynetwork/README.md.

---

Features

✔️ Multi-source network dashboard (Freebox, UniFi, network scan)
✔️ Ingress only — no port exposure, UI in sidebar
✔️ Persistence in /data (database, config, tokens)
✔️ Watchdog and custom AppArmor profile
✔️ Compatible with Home Assistant 2025.x / 2026.x (Supervisor, Settings → Apps)
✔️ Options: jwt_secret, freebox_host, log level

---

Installation

1. Open the Home Assistant Add-on Store
   Access the Store

2. Add this repository

   https://github.com/Erreur32/HA_mynetwork
   

3. Search for "MynetworK" in the Add-on Store

4. Install the add-on and Start it

5. Open MynetworK from the sidebar (Ingress panel)

---

Configuration

Configure the add-on in the Configuration tab. Main options:

Option	Description
log_level	debug / info / warning / error
jwt_secret	Required in production — secures sessions
freebox_host	Optional (e.g. mafreebox.freebox.fr)

Note: Admin credentials (username, password, email) are managed by the MynetworK app itself, not in the HA add-on config. See "First run" below.

See mynetwork/DOCS.md for full documentation — Version française.

---

Usage

• UI: Open the MynetworK panel from the Home Assistant sidebar. No URL or port to remember.
• Data: Stored in the app data volume (/data): database, config, Freebox token. Data persists across restarts and updates.

First run

On first launch (empty database), the app automatically creates a default admin account:

Username	admin
Password	admin123

1. Log in with these default credentials.
2. Change the password immediately via the MynetworK UI (user settings).
3. Configure your plugins (Freebox, UniFi, Network Scan) in Plugins.
4. Set a strong jwt_secret in the add-on Configuration tab.

Credentials are stored in the app database and managed entirely via the MynetworK UI. They are never overwritten by the add-on configuration on restart.

---

Support

Questions or issues? Open an issue: issue tracker.

Contributing

This is an open-source project. Contributions are welcome.

Authors & contributors

The original setup of this repository is by Erreur32.

For a full list of contributors, see the contributor's page.

License

MIT License — see the LICENSE file for details.