eeroVista

Logo

Read-only monitoring for Eero mesh networks

View the Project on GitHub Yeraze/eeroVista

Getting Started with eeroVista

This guide will help you set up and run eeroVista for the first time.

Prerequisites

Installation

  1. Clone the repository: 
    git clone https://github.com/yeraze/eerovista.git
cd eerovista
  2. Create data directory: 
    mkdir data
  3. Start the container: 
    docker compose up -d
  4. View logs: 
    docker compose logs -f eerovista

Method 2: Docker Run

docker run -d \
  --name eerovista \
  -p 8080:8080 \
  -v $(pwd)/data:/data \
  --restart unless-stopped \
  eerovista:latest

Initial Setup

First Run Wizard

  1. Open your browser to http://localhost:8080 (or your server’s IP)

  2. You’ll be prompted to authenticate with Eero:
    • Enter the phone number associated with your Eero account
    • Click “Send Verification Code”
    • Enter the 6-digit code received via SMS
    • Click “Verify”
  3. Once authenticated, eeroVista will:
    • Discover your Eero network(s)
    • Identify all mesh nodes
    • Begin collecting device metrics
    • Start populating the database
  4. Allow 2-3 minutes for initial data collection before viewing the dashboard

Configuration

Environment Variables

Edit docker-compose.yml to customize collection intervals and retention:

environment:
  # Collection intervals (seconds)
  - COLLECTION_INTERVAL_DEVICES=30      # How often to collect device metrics
  - COLLECTION_INTERVAL_NETWORK=60      # How often to collect network metrics

  # Data retention (days)
  - DATA_RETENTION_RAW_DAYS=7           # Keep raw data for 7 days
  - DATA_RETENTION_HOURLY_DAYS=30       # Keep hourly aggregates for 30 days
  - DATA_RETENTION_DAILY_DAYS=365       # Keep daily aggregates for 1 year

  # Logging
  - LOG_LEVEL=INFO                      # DEBUG, INFO, WARNING, ERROR

Restart to Apply Changes

docker compose down
docker compose up -d

Accessing eeroVista

Web Interface

API Endpoints

See API Reference for complete endpoint documentation.

What You’ll See

Dashboard

Dashboard

After initial data collection completes, the dashboard will display:

Reports

The Reports page (http://localhost:8080/reports) provides:

Device List

Device List

The Devices page shows all connected devices with:

Device Groups

Many devices connect to your network over both wired and wireless interfaces, appearing as two separate entries. Device Groups let you combine these into a single logical device:

  1. Click Create Device Group on the Devices page
  2. Name the group and select the member devices
  3. Click Create Group

Grouped devices appear as a single row in the device table with aggregated bandwidth and a link icon (🔗). Click a group to see:

You can edit or ungroup devices at any time from the group detail modal.

Troubleshooting

Authentication Issues

If authentication fails:

  1. Verify the phone number is correct (include country code if international)
  2. Check that you have mobile app access to your Eero network
  3. Ensure you’re receiving SMS codes
  4. Try clearing browser cache and retrying

Amazon Login Accounts: If your Eero account is linked to Amazon for login, direct authentication with eeroVista will not work due to API limitations.

Workaround: Create a separate Eero account using email/password authentication and have the account owner invite this new account as an admin to the network. Then use these credentials to authenticate eeroVista.

I See Devices But No Bandwidth Data

This is normal behavior. eeroVista cannot access historical bandwidth data from before it was started. Only data collected after the container launches will be tracked and displayed.

What to expect:

Tip: Leave the container running continuously to build up historical data over days and weeks.

No Data Appearing

  1. Check logs for errors: 
    docker compose logs eerovista
  2. Verify authentication succeeded: 
    docker compose exec eerovista cat /data/eerovista.db | grep session
  3. Wait 2-3 minutes for initial data collection

Container Won’t Start

  1. Check port 8080 is not in use: 
    netstat -tlnp | grep 8080
  2. Verify data directory permissions: 
    ls -la data/
  3. Check Docker logs: 
    docker compose logs eerovista

Notifications

eeroVista supports configurable notifications for network events. To set up notifications:

  1. Go to the Settings page (http://localhost:8080/settings)
  2. Configure your Apprise URLs - these define where notifications are delivered (email, Slack, Discord, Telegram, webhooks, and 100+ other services via Apprise)
  3. Use Send Test to verify delivery works
  4. Create Notification Rules to define what triggers alerts:
    • Node Offline: Alert when mesh nodes go down
    • Device Offline: Alert when specific devices disconnect
    • New Device: Alert when an unknown device joins the network
    • High Bandwidth: Alert when bandwidth exceeds a threshold
    • Firmware Update: Alert when firmware updates are available
  5. Each rule has a configurable cooldown period (default: 60 minutes) to prevent repeated alerts

Notification rules are evaluated every 60 seconds (configurable via NOTIFICATION_CHECK_INTERVAL).

Next Steps

Support

For issues and questions: