Skip to content
BretterooPublic

About

A beautifully designed, locally-hosted web interface for managing Eero mesh networks.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

32 Commits

Folders and files

Repository files navigation


Eeronaut


A locally-hosted web-based dashboard for managing Eero mesh networks

license: AGPL-3.0-only Python 3.11 or newer FastAPI: backend React: 19 TypeScript: 6 Vite: 8 Tailwind CSS: 4

Support Eeronaut


Set sail for fun and adventure!

...without your phone!

๐Ÿ“š Features | ๐ŸŽจ Themes | ๐Ÿš€ Get Started | ๐Ÿ’™ Contributions | ๐Ÿ‘๐Ÿป Acknowledgements | ๐Ÿ”’ License


Eeronaut

Eerish theme, Dashboard Eerish theme, Airtime Eerish theme, Clients

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.


๐Ÿ“š Features

  • ๐Ÿ–ฅ๏ธ 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.

๐ŸŽจ Themes

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.

Eerish Eerish theme, Dashboard
Eerish theme, Dashboard
Dashboard
Eerish theme, Clients, with a client's details open
Clients, with a client's details open
Eerish theme, Topology
Topology
Eerish theme, Activity > Airtime
Activity > Airtime
Eerish theme, Security
Security
Sailing Sailing theme, Dashboard, with Clients, Airtime, Security, and Topology behind it
Sailing theme, Dashboard
Dashboard
Sailing theme, Clients, with a client's details open
Clients, with a client's details open
Sailing theme, Topology
Topology
Sailing theme, Airtime
Airtime
Sailing theme, Security
Security
Liquid Glass Liquid Glass theme, Dashboard, with Clients, Airtime, Security, and Topology behind it
Liquid Glass theme, Dashboard
Dashboard
Liquid Glass theme, Clients, with a client's details open
Clients, with a client's details open
Liquid Glass theme, Topology
Topology
Liquid Glass theme, Airtime
Airtime
Liquid Glass theme, Security
Security
Harbor Harbor theme, Dashboard, with Clients, Airtime, Security, and Topology behind it
Harbor theme, Dashboard
Dashboard
Harbor theme, Clients, with a client's details open
Clients, with a client's details open
Harbor theme, Topology
Topology
Harbor theme, Airtime
Airtime
Harbor theme, Security
Security
Winksys Winksys theme, Status, Router, with Local Network, Wireless, Firewall, and Basic Setup behind it
Winksys theme, Status > Router
Status > Router
Winksys theme, Status > Local Network, with a client's details open
Status > Local Network, with a client's details open
Winksys theme, Status > Wireless
Status > Wireless
Winksys theme, Security > Firewall
Security > Firewall
Winksys theme, Setup > Basic Setup
Setup > Basic Setup

๐Ÿซธ๐Ÿป What it isn't

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.

๐Ÿš€ Get Started

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 Eeronaut

  • Install Docker.
    • If you're on macOS, enable Host Networking within Docker Desktop - it's disabled by default.
  • Download docker-compose.yml into 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?)

Future Updates

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.

Install Eeronaut

  • 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.

Future Updates

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 venv module. 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.

Install Eeronaut

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 .

Tell it to stick around

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.

Future Updates

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

Just use Docker

Way easier.

๐Ÿ’™ Contributions

Issue reports are encouraged. If you've got ideas for improvements or find bugs, please open an issue.

๐Ÿ‘๐Ÿป Acknowledgements

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

๐Ÿ”’ License

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.

About

A beautifully designed, locally-hosted web interface for managing Eero mesh networks.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages