A locally-hosted web-based dashboard for managing Eero mesh networks
Set sail for fun and adventure!
...without your phone!
๐ Features | ๐จ Themes | ๐ Get Started | ๐ Contributions | ๐๐ป Acknowledgements | ๐ License
Eeronaut brings browser-based management to Eero mesh networks.
A human designed Eeronaut and Claude Code built it. Best to be up-front about these things.
Nearly every feature included in Eero's mobile apps is included in Eeronaut...plus some new ones!
Eeronaut is not affiliated with eero LLC or Amazon.com, Inc. and was created by an enthusiastic end user.
- ๐ฅ๏ธ A real web interface
- Modern and responsive.
- ๐จ Fully themeable
- Ships with several! Some nice. Some not. Build your own!
- ๐งน Hides internal spam
- Not an eero Plus subscriber? Hide the disabled features that require it.
- ๐บ๏ธ Topology map
- See which devices are connected to which eeros at a glance.
โ ๏ธ Restart warnings- No more "Oh, I guess that toggle takes my network down for a bit."
- ๐ป Radio channels and airtime graphs
- View graphs of band assignments and airtime usage.
- ๐ More DNS options
- Several external DNS providers now included.
- ๐ Embeddded DDNS provider support
- Adds configs for several Dynamic DNS services.
- ๐ช IPv4 and IPv6 forwarding improvements
- Much less clunky than the mobile app.
- ๐ Speed tests against the speed you pay for
- Raise hell with your ISP when they don't deliver.
- ๐ฃ๏ธ Multilingual
- More languages than you have fingers.
- โ๏ธ AGPL-3.0-only
- Because free software should stay that way.
- ๐ค Guaranteed Non-Slop
- I built this because I wanted it for myself. It took weeks of careful curation to get it to 1.0. It is good.
Eeronaut ships with a modular theming system and a few themes to show what's possible.
You can make your own themes, or just ask your robot to do it.
Check THEMES.md for more info.
Winksys
![]() Status > Router |
![]() Status > Local Network, with a client's details open |
![]() Status > Wireless |
![]() Security > Firewall |
![]() Setup > Basic Setup |
Eeronaut isn't the local web controller we've all been waiting years for. It's the closest thing possible, I think.
It might be easier to think of Eeronaut as a locally-hosted front end for the eero cloud.
Eero's own mobile apps are slaves to the cloud. Their Android and IOS apps make changes on the eero cloud, and those changes are then pushed down to your eero devices. That's just how they work. Eeronaut does the same thing.
There isn't a route to make changes locally to your Eero devices (as far as anyone knows), and most discovered local calls to Eero devices are read-only.
Eeronaut is also not a way to get eero Plus features for free. Eero Plus features are disabled unless a subscription is detected.
Docker is the recommended way to run Eeronaut: one command to install, one to update, and nothing else to set up on the machine.
If you run Home Assistant, Eeronaut can also be installed as a Home Assistant app.
Images are provided for linux/amd64 and linux/arm64. Eeronaut is lightweight enough for Raspberry Pi.
Important
Eeronaut requires a native Eero account.
If you sign in to the Eero app with your Amazon credentials, you'll first need to send yourself an invitation to manage your Eero account via the Eero Mobile app:
- Settings / User Permissions / + / Invite admin
- Accept the invitation, and you'll then be able to login to Eeronaut using that email address or phone number.
Install With Docker (recommended)
- Install Docker.
- If you're on macOS, enable Host Networking within Docker Desktop - it's disabled by default.
- Download
docker-compose.ymlinto a folder of its own. - Then, from the folder holding
docker-compose.yml:
docker compose up -d
Find it at http://localhost:3340. (Get it?)
From the same folder:
docker compose pull && docker compose up -d
Install in Home Assistant
You'll need Home Assistant OS or a Supervised install. Container and Core installs can't run apps, so use Docker there instead.
- In Home Assistant, go to Settings > Apps and choose Install App.
- Open the โฎ menu at the top right, choose Repositories, and add
https://github.com/Bretteroo/Eeronaut. - Find Eeronaut in the store, then install and start it.
- Turn on Show in sidebar.
Eeronaut then appears in Home Assistant's sidebar for Home Assistant's administrators. Phones and other computers can also open it directly at http://homeassistant.local:3340, with a password you choose in Eeronaut's Settings from the sidebar.
Home Assistant offers each new Eeronaut release as an app update, alongside its own updates.
Install Without Docker
You'll need:
- Python 3.11 or newer, with its
venvmodule. On Debian, Ubuntu, and Raspberry Pi OS that's a separate package:sudo apt install python3-venv. - Node.js 22.12 or newer (or 20.19 or newer on Node 20), to build the interface.
- git.
sudo mkdir /opt/eeronaut
sudo chown $USER: /opt/eeronaut
git clone https://github.com/Bretteroo/Eeronaut.git /opt/eeronaut
cd /opt/eeronaut/app/frontend
npm ci
npm run build
cd ../backend
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/pip install --no-deps -e .
To start Eeronaut when the machine boots (and keep it running), we turn to good ol' systemd.
Save this as /etc/systemd/system/eeronaut.service:
[Unit]
Description=Eeronaut
After=network-online.target
Wants=network-online.target
[Service]
DynamicUser=yes
StateDirectory=eeronaut
Environment=EERONAUT_DATA_DIR=/var/lib/eeronaut
WorkingDirectory=/opt/eeronaut/app/backend
ExecStart=/opt/eeronaut/app/backend/.venv/bin/uvicorn eeronaut.main:app --host 0.0.0.0 --port 3340
Restart=on-failure
ProtectSystem=strict
ProtectHome=yes
PrivateTmp=yes
[Install]
WantedBy=multi-user.target
Then sudo systemctl daemon-reload && sudo systemctl enable --now eeronaut.
Find it at http://localhost:3340. (Get it?) To use a different port, change --port in the ExecStart line.
cd /opt/eeronaut && git pull
cd app/frontend && npm ci && npm run build
cd ../backend && .venv/bin/pip install -r requirements.txt && .venv/bin/pip install --no-deps -e .
sudo systemctl restart eeronaut
Way easier.
Issue reports are encouraged. If you've got ideas for improvements or find bugs, please open an issue.
There are a few other projects in this space. Give them a try!
๐น Eero UI by Fulvio Freitas
๐น eero Dashboard by xrvk
๐น eero Custom Dashboard by Enrico Flammini
This project is licensed under AGPL-3.0-only: the GNU Affero General Public License, version 3, and no later version. The full text is in LICENSE.
Eeronaut is not affiliated with, endorsed by, or supported by eero LLC. "eero" is a trademark of Amazon Technologies, Inc.





























