# ioBroker.aura **Aura** is a modern visualization dashboard for [ioBroker](https://www.iobroker.net/). 📖 **[Documentation](https://hdering.github.io/ioBroker.aura/)** – widgets, settings, screenshots --- ## Installation ### Step 1 – Install adapter Install Aura via ioBroker Admin: 1. Open ioBroker Admin 2. Go to **Adapters** 3. Search for **Aura** and install it ### Step 2 – Create instance After installation, create a new **Aura** instance (if not done automatically). ### Step 3 – Configure the instance Aura runs its **own web server** (frontend + built-in iframe proxy) and connects to an existing `iobroker.web` instance only for the socket.io data connection. Open the **Aura** instance settings: | Setting | Default | Meaning | |---------|---------|---------| | **Port** | `8095` | Port of Aura's HTTP server (frontend + iframe proxy) | | **ioBroker socket port** | `8082` | Port of the `iobroker.web` instance that provides the socket.io connection | | **Web adapter uses HTTPS** | off | Enable if that web instance runs HTTPS | > **Requirement:** A running `iobroker.web` (or `iobroker.socketio`) instance must serve socket.io on > the configured socket port. The stock `web.0` with **socket.io = integrated** provides this on > port `8082` (the default). Aura auto-detects the matching instance and proxies the connection > internally, so no `/aura/` path or web extension is needed anymore. ### Step 4 – Open dashboard The dashboard is available at: ``` http://:8095/ ``` The admin interface at: ``` http://:8095/#/admin ``` --- ## HTTPS / Reverse Proxy Aura can serve HTTPS in two ways. ### Option A – Built-in TLS Enable **Use HTTPS** in the Aura instance settings and select the certificates (loaded from ioBroker `system.certificates`). Aura's own server then serves `https://:8095/`. > The default self-signed certificate triggers a browser warning. For a clean setup use proper > certificates (e.g. Let's Encrypt) or put Aura behind a reverse proxy (Option B). ### Option B – Reverse proxy Point a reverse proxy (e.g. **nginx**, **Nginx Proxy Manager**, **Caddy**) with a valid TLS certificate at Aura's port. Aura proxies the socket.io connection to the web instance internally, so a single forwarded port is enough. #### Nginx Proxy Manager – example configuration | Field | Value | |-------|-------| | Forward Scheme | `http` | | Forward Hostname / IP | `` | | Forward Port | `8095` | | Websockets Support | enabled | > **Alternative topology:** If you instead proxy `/socket.io/` and `/echarts/` directly to the web > adapter port, set **ioBroker socket URL (override)** in the Aura settings to your public URL > (e.g. `https://your-domain.com`) so the frontend connects socket.io to the right endpoint. --- ## Bugs & Feature Requests Please report directly as a GitHub issue: **[github.com/hdering/ioBroker.aura/issues](https://github.com/hdering/ioBroker.aura/issues)** --- ## Versioning Aura uses a simple scheme so you can tell stable releases from test builds at a glance: | Version | Meaning | |---------|---------| | `0.10.2-next1`, `0.10.2-next2`, … | **Test builds** for the upcoming `0.10.2` release. Pre-releases, published for testing only. | | `0.10.1` in the **Latest** repo | A published release in ioBroker's *Latest* repository. Available to everyone, but still on probation — not yet promoted to *Stable*. | | `0.10.1` in the **Stable** repo | The same version after it has proven itself error-free in the field. This is the truly stable build. | - A **`-nextN` suffix** marks a pre-release. The number counts the test builds leading up to the next plain version (`next1`, `next2`, …). Pre-releases are **not** offered automatically in ioBroker; you only get them if you explicitly install that version. - A **plain number** (`0.10.1`, `0.10.2`, …) is first published to ioBroker's **Latest** repository. This makes it generally available, but *Latest* is the proving ground — one step before truly stable. - Once a *Latest* release has run long enough with no errors reported, the **same version** is promoted to the **Stable** repository. Only then is it considered fully stable. So the path of any release is: `-nextN` test build → **Latest** (published, on probation) → **Stable** (promoted once confirmed error-free). --- ## Changelog _Older releases: see [CHANGELOG_OLD.md](CHANGELOG_OLD.md)._ ### 0.36.5 (2026-07-26) - Design - resetting per-layout header overrides now activates Save and persists after reload ### 0.36.4 (2026-07-26) - Guidelines - horizontal guide line now lines up between the editor and the frontend (it accounts for the header and tab/section bar, so it marks the target device's bottom edge in both) ### 0.36.3 (2026-07-26) - Timer - new option to hide the astro symbol so only the resolved time is shown - JSON table - per-column prefix and suffix to decorate cell values (e.g. units or currency) - Group - transparent groups now stay transparent when opened via the "Popup: widget content" click action - Group - resizing a child in the editor no longer rescales the other children (fixed-grid pitch while editing) ### 0.36.2 (2026-07-25) - Timer - astro events now show the resolved sunrise/sunset time next to the symbol - Timer - all events are now shown in a scrollable list instead of being cut off at 4 ### 0.36.1 (2026-07-25) - Settings - Grid & Mobile can now hide the draggable dashboard scroll bar on touch devices ### 0.36.0 (2026-07-25) - 🌟 **New feature:** Menu - new freely positionable navigation widget: shows the sections or the tabs as a menu, with per-widget de-selection of entries, four layouts (horizontal bar, vertical list, grid, pills) and four active styles ### 0.35.3 (2026-07-25) - Universal widget - string datapoints are no longer coerced to numbers when no value factor/offset is set, so values like "0x004" display as-is instead of being parsed as hex ### 0.35.2 (2026-07-25) - Popup (widget content) - embedded widget now fills the configured popup width/height instead of collapsing to a narrow box; without an explicit size it uses the widget's own designed size, so groups no longer squeeze their children ### 0.35.1 (2026-07-25) - General - widget config changes (e.g. a widget's data point) no longer revert after saving when auto-backups are at their limit ### 0.35.0 (2026-07-25) - 🌟 **New feature:** Mirror - new widget type that shows an existing widget live at a second position (no copy; source changes apply instantly) ### 0.34.0 (2026-07-25) - 🌟 **New feature:** Editor - a whole tab (with its widgets) can now be moved or copied into another section from the tab settings - 🌟 **New feature:** Layouts - a whole section (with its tabs and widgets) can now be moved or copied into another layout via a popup on each section ### 0.33.8 (2026-07-24) - Carousel - compact layout settings plus corner radius, global background/text colours, and per-element colours (now also for popup/link items) that override the global ones - Carousel - popup opened from an element now shows the element name as its heading instead of the carousel widget name ### 0.33.7 (2026-07-24) - Settings - header HTML template field now grows across multiple lines ### 0.33.6 (2026-07-24) - General - dashboard now shows a visible, draggable scrollbar on tablets and phones when the content overflows (native touch scrollbars stay hidden until you scroll) - Quick-access chips - add an adjustable corner radius (square to pill), global background and text colours, plus per-chip background and text colour overrides - Quick-access chips - in the grid (fixed columns) arrangement all chips now share the widest chip's width, and the alignment setting positions the label inside each chip ### 0.33.5 (2026-07-24) - Section menu and tab bar now keep their configured center/right alignment on mobile instead of snapping to the left - Tab bar and section menu bar now keep their subtle divider line facing the dashboard when placed as a footer ### 0.33.4 (2026-07-23) - Group - now wraps its children with one equal spacing on all four sides and between widgets (no empty row below), with or without a title/icon; when title and icon are disabled the editor header strip is gone and the group's move/menu controls appear as a small toolbar on hover - Group - an icon-only group (title off, icon on) now shows its icon header in the live view too, matching the editor ### 0.33.3 (2026-07-18) - 🌟 **New feature:** EVCC - grid power now reads from the JSON `status.grid` object as well, so it keeps working on adapters that expose resolved/nested nodes instead of a flat gridPower state - 🌟 **New feature:** Universal widget - button cells (switch in button mode) can now be sized to full cell width or matched to the widest label so buttons line up evenly regardless of text length ### 0.33.2 (2026-07-16) - Distribution chart - configurable frontend time-range selector (1h/6h/24h/7d/30d/custom) with an option to lock the range ### 0.33.1 (2026-07-15) - Editor - tab bar now always stays on top in the editor; the footer (bottom) position applies to the frontend only - Editor - the section menu is only previewed in the editor when set to "fixed sidebar"; top/bottom bar placement no longer moves the editor preview - Tab bar - global clock/datapoint/text items are now inherited by every layout and section (also on single-tab sections); per-scope items are added on top instead of hiding the global ones - Tab bar - the datapoint template field now grows with multiple lines and hints that HTML is supported - Tab bar - the datapoint item ID can now be chosen via the standard datapoint picker ### 0.33.0 (2026-07-14) - 🌟 **New feature:** Static & Dynamic List - the "states" entry display was renamed to a more generic "value mapping" - 🌟 **New feature:** Static & Dynamic List - new "window/door contact" entry display reusing the contact widget's value presets (HmIP / boolean / numeric / string / custom) to map values to open / tilted / closed, with editable label, color and icon per state ## License MIT License Copyright (c) 2026 Hermann Dering Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.