|
1 | 1 | <!-- markdown file presented on the main addon info tab --> |
2 | 2 |
|
| 3 | +<img src="https://upload.wikimedia.org/wikipedia/commons/d/d3/Emhass_logo.svg" alt="EMHASS" width="300px"> |
| 4 | + |
3 | 5 | # EMHASS Add-on |
4 | 6 |
|
5 | 7 | ### A Home Assistant Add-on for the EMHASS module: Energy Management for Home Assistant |
| 8 | +<a style="text-decoration:none" href="https://github.com/davidusb-geek/emhass/releases"> |
| 9 | + <img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/davidusb-geek/emhass"> |
| 10 | + </a> |
| 11 | +<a style="text-decoration:none" href="https://github.com/davidusb-geek/emhass/blob/master/LICENSE"> |
| 12 | + <img alt="GitHub" src="https://img.shields.io/github/license/davidusb-geek/emhass"> |
| 13 | + </a> |
6 | 14 |
|
7 | 15 | </br> |
8 | 16 |
|
@@ -46,13 +54,40 @@ For any Issues/Feature Requests for the EMHASS core module, create a new issue h |
46 | 54 |
|
47 | 55 | ## Installation |
48 | 56 |
|
49 | | -The steps to install EMHASS as an Home Assistant addon: |
| 57 | +The steps to install EMHASS as a Home Assistant add-on: |
| 58 | + |
| 59 | +1) Add the EMHASS-Add-on repository to the HAOS add-on store |
| 60 | +<a href="https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fdavidusb-geek%2Femhass-add-on" target="_blank" rel="noreferrer noopener"><img src="https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg" alt="Open your Home Assistant instance and show the add-on repository dialog with a specific repository URL pre-filled." /></a> |
| 61 | + |
| 62 | +2) Install the EMHASS Add-on |
| 63 | +<a href="https://my.home-assistant.io/redirect/supervisor_addon/?addon=5b918bf2_emhass" target="_blank" rel="noreferrer noopener"><img src="https://my.home-assistant.io/badges/supervisor_addon.svg" alt="Open your Home Assistant instance and show the dashboard of an add-on." /></a> |
| 64 | +Click on `install`, the installation may take some time depending on your hardware. |
| 65 | + |
| 66 | +4) Start the EMHASS addon |
| 67 | + - Once installed, head into the EMHASS addon |
| 68 | + - click `start` to start the EMHASS web server |
| 69 | + - For consistent use, it is recommended that you enable: `Show in sidebar`,`Watchdog` and `Start on boot ` |
| 70 | + |
| 71 | +5) Open the EMHASS web interface, and configure parameters |
| 72 | + - Click `OPEN WEB UI` to enter the EMHASS web server |
| 73 | + - Click the cog icon ⚙️ to enter the emhass configuration page |
| 74 | + - Insert your user-specific parameters |
| 75 | + - Insert your user specific parameters |
| 76 | + - For users who wish to use `Solcast` or `Forecast.Solar` insert your secrets in the Home Assistant EMHASS configuration page, under `Show unused optional configuration options` (e.g., `localhost:8123/hassio/addon/emhass/config`). |
| 77 | + |
50 | 78 |
|
| 79 | +<details> |
| 80 | +<summary><b> Manual install steps</b></summary> |
| 81 | + |
| 82 | +## Installation Method 1 |
51 | 83 | 1) Add the EMHASS-Add-on repository to the HAOS add-on store |
52 | 84 |
|
53 | | - - To install add the EMHASS Add-on repository in the Home Assistant store, follow [these steps](https://www.home-assistant.io/common-tasks/os/#installing-third-party-add-ons) |
| 85 | + - To install add the EMHASS Add-on repository in the Home Assistant store, follow [these steps](https://www.home-assistant.io/common-tasks/os/#installing-a-third-party-add-on-repository) |
54 | 86 |
|
55 | | - - This will be: Configuration > Add-ons & Backups open the add-on store > Add the URL of the repository (e.g https://github.com/davidusb-geek/emhass-add-on) and then press "Add". |
| 87 | + - This will be: Open the add-on store with the button below, or go to settings in HA, select add-on and the add-on store. |
| 88 | + <a href="https://my.home-assistant.io/redirect/supervisor_store/" target="_blank" rel="noreferrer noopener"><img src="https://my.home-assistant.io/badges/supervisor_store.svg" alt="Open your Home Assistant instance and show the add-on store." /></a> |
| 89 | + - Press the 3 dots and choose repository. |
| 90 | + - Add the URL of the repository (e.g https://github.com/davidusb-geek/emhass-add-on) and then press "Add". |
56 | 91 |
|
57 | 92 | 2) Install the EMHASS Add-on |
58 | 93 | - Look for the EMHASS Add-on tab and when inside the Add-on click on `install`. |
@@ -99,6 +134,7 @@ _Warning: This method will override the Docker image tag, and therefore will req |
99 | 134 | - From here a new Addon Source under the name `Local add-ons` should appear _(if not repeat step 4)_ |
100 | 135 | - Install the EMHASS addon, Note: after clicking the EMHASS addon, the `Current version: ` Tag on the top left of the EMHASS card. |
101 | 136 |
|
| 137 | +</details> |
102 | 138 |
|
103 | 139 | ## Developing EMHASS/EMHASS-Add-on |
104 | 140 |
|
|
0 commit comments