Athena documentation
Everything from installing Athena to what each part of the app does. Start at Installation if you're setting up a new instance, or jump straight to whatever you're looking for - the sidebar on the left stays with you on every page.
Getting started
Installation & deployment
Docker Compose, environment variables, and HTTPS.
First-time setup
The one-time admin setup wizard, and signing in after that.
Interface overview
The sidebar, theming, and where each section lives.
Using Athena
One page per item in the sidebar, alphabetically.
Account & preferences
Theme, language, font size, and contact details.
AI Assistant
Your own Chat/STT/TTS servers, the chat page, and the AI automation node.
Automations
The drag-and-drop flow editor.
Backup & Restore
Download and restore your whole configuration as one file.
Dashboards
Card types, icons, and the default-dashboard home page.
Devices & Services
The hub every integration hangs off - hidden until configured.
Energy
Grid, solar, gas, water, and per-device consumption view with a rough cost estimate.
History
Open-ended multi-entity graphs over any date range.
Locations & Areas
A Location's Areas, each with their own Floor.
Logs
Browse Athena's own log right in the app, with filters.
Notifications
New devices and new versions, with read/unread state.
Plugins
Custom card and integration plugins, written in your own JavaScript.
Settings
Database engine, ports, and history retention.
Users & roles
Add accounts with an Admin, User, or View only role.
Add-ons
Integrations
Every device source Athena connects to, alphabetically - see Devices & Services above for the hub they all live in.
AccuWeather
Current conditions and a 5-day forecast, with your own AccuWeather API key.
ADB (Android Debug Bridge)
Control Android TV / Android devices directly over the raw ADB protocol.
Android TV
Google's own Android TV Remote v2 protocol, PIN-paired.
Aqara
An Aqara hub and its own sub-devices over the local LAN API.
Bluetooth
Track any nearby BLE device by RSSI and presence.
BTHome
BTHome-protocol BLE sensors and buttons, decoded locally.
Caruna
Your own Caruna electricity consumption today, yesterday, and this month.
Companion App
Any device running the Athena Android app (a phone, or a wall-mounted tablet) reports its own battery, screen, network, and Do Not Disturb state.
Cozify HAN
Real-time power, voltage, current, and consumption from your meter's own HAN port.
DaisyFamily
The early-education family portal - unanswered messages and permissions, bulletins, and each child's next care time.
deCONZ
A deCONZ/ConBee/RaspBee gateway and its own end devices.
Denon AVR
Denon/Marantz receivers over HTTP or Telnet, with Zone2/Zone3.
ESPHome
Discover, connect to, and control devices over their own API.
ESPHome builder
Config files, the file manager, dashboard compiles, and flashing firmware.
Finnish Meteorological Institute
Finnish Meteorological Institute Open Data - no API key needed.
Fortum
Your own Fortum electricity consumption today, yesterday, and this month.
Google Calendar
Current/next event sensors, a month-view calendar page, and creating events from an automation.
Google Cast
Discover, connect to, and control Chromecast devices.
Google Drive
Storage usage sensors and a backup destination on your own Google account.
Google Mail
Sending email from an automation, plus inbox message-count sensors.
Google Maps
Live drive or transit time between two points, with your own API key.
Google Photos
Upload photos from an automation into an Athena-owned Google Photos album.
Helen
Your own Helen electricity consumption today, yesterday, and this month.
HomeWizard
Energy Socket, P1 Meter, kWh Meter, Watermeter, and Plug-In Battery.
IKEA DIRIGERA
The DIRIGERA smart-home hub over its own local API.
IKEA IDĂ SEN
The sit/stand desk over Bluetooth LE.
IKEA SYMFONISK
SYMFONISK speakers over Sonos's own local API.
Infrared
Control IR remote devices via Broadlink, Tasmota, or ESPHome IR Proxy - TV/amplifier/DVD/Blu-ray code presets, plus air conditioner control (Coolix/Gree/Mitsubishi/Daikin).
iRobot
Wi-Fi Connected Roomba vacuums.
Jamix
A school / daycare lunch menu from fi.jamix.cloud - today's and tomorrow's food, plus special-diet codes.
KNX
KNXnet/IP gateways, addressed by your own group addresses.
Kouluruoka.fi
A kouluruoka.fi menu - today's and tomorrow's lunch and vegetarian lunch, E-codes, and kcal.
LD2410 BLE
A BLE mmWave presence sensor, added by live scan.
LG TV (webOS)
LG's own local WebSocket remote-control API.
Logitech Harmony Hub
Activities and device commands through a Harmony Hub.
LoRa32 433MHz
A LoRa32 433MHz gateway and its own received codes.
Matter
Connect to an already-running matter-server instance.
Media player
One unified card for Sonos, Spotify, Denon, and TV playback.
Met.no
The Norwegian Meteorological Institute - no API key needed.
Miele
One Miele@home account, multiple appliances, connected via a real OAuth2 login.
MOS
A self-hosted homelab/server OS.
MQTT auto-discovery
Any device already speaking the standard MQTT discovery convention.
Nord Pool
Live Nordic/Baltic electricity spot prices by delivery area.
Notify
Push notifications to your phone via ntfy - works out of the box.
OctoPrint
3D-printer monitoring and control over OctoPrint's own API.
OpenWeatherMap
Current conditions and a 5-day forecast, with your own API key.
Panasonic
Viera smart TVs over the local network, plus Comfort Cloud air conditioners via the cloud.
Philips
Hue (bridge and Bluetooth), smart TVs, and the Dynalite lighting system.
Pi-hole
Pi-hole's own blocking stats and controls.
Plex
See what's playing right now on your Plex server.
Portainer
Docker container status and control through Portainer.
Presence detection
Attach any entity as an Area's own presence source.
Proxmox VE
VM/LXC guest status and control on a Proxmox VE node.
PörssÀri
Finnish electricity-spot-price relay control - up to 8 channels.
Ruuvi
RuuviTag sensors over their own BLE broadcast format.
Samsung TV (Tizen)
Samsung's own remote-control WebSocket API.
Sensibo
Control cloud-connected air conditioner units.
Sensirion BLE
Sensirion BLE sensor gadgets over their own broadcast format.
Shelly
Gen2/Gen3 devices over their own local JSON-RPC API.
Siemens
Appliances via BSH's shared "Home Connect" cloud platform - also Bosch/Neff/Gaggenau.
Sonos
Sonos speakers over their own local UPnP/SOAP API.
Sony
Bravia TV, Songpal, Projector, PlayStation 4, and PlayStation Network - one row for five integrations.
Spotify
Playback control and status via Spotify's own Web API.
Sun
Solar elevation, azimuth, and sunrise/sunset for a given location.
System info
The Athena server's own CPU, memory, disk, and version.
Tasmota
Tasmota-flashed devices over their own local HTTP API.
Tuya
Tuya-protocol devices, paired via a one-time cloud step.
Ubiquiti
UniFi network controller sites, devices, and clients.
Ulanzi Smart Pixel Clock
AWTRIX-based pixel clocks and their own apps.
Unraid
Via the Unraid Connect plugin's GraphQL API.
Wilma
A school Wilma account - your children's timetable, homework, exams and attendance, plus your Wilma inbox.
WLED
WLED-controlled LED strips over their own local JSON API.
YouTube
Watch any public channel, or sign into your own account to add videos to a playlist.
Z-Wave
Bridges to zwave-js-server and its own network of nodes. Works with any Z-Wave USB stick, including Home Assistant's own Connect ZWA-2.
Zigbee
An EZSP Zigbee gateway and its own end devices.