mirror of
https://github.com/mtan93/homeassistant-addons.git
synced 2026-03-08 05:21:51 +00:00
59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
# Home Assistant Add-on: ioBroker
|
|
|
|
## Installation
|
|
|
|
After installation, and successful startup, the ioBroker instance should be available at port `8081`.
|
|
If your HA instance is running with SSL support, the `OPEN WEB UI` button might not work correctly.
|
|
|
|
**Note:** As this image is not based on the official home assistant add-on images the Supervisor has some delay on the add-on state (i guess this is the reason).
|
|
It might be up and running while the `Info` tab is not aware of this right now. Page reload might help.
|
|
|
|
## Updating `js-controller`
|
|
|
|
The bundled `js-controller` is not (always) the most recent version. (Thanks to _tintim_ [#21](1)).
|
|
|
|
Updating can be archived manually via `portainer` or by using the [`eval` setting](<#eval-(string)>).
|
|
|
|
Manually:
|
|
Jump into the container via `portainer` and run line by line:
|
|
|
|
```bash
|
|
maintenance on
|
|
iobroker update
|
|
iobroker upgrade self
|
|
curl -sL https://iobroker.net/fix.sh | bash
|
|
```
|
|
|
|
## Configuration
|
|
|
|
### `eval` (string)
|
|
|
|
Allows to pass some bash commands to run every time before the start of ioBroker.
|
|
|
|
This can be used e.g. to upgrade the `js-controller`.
|
|
|
|
Example:
|
|
|
|
```yaml
|
|
eval: "iobroker update && iobroker upgrade self"
|
|
```
|
|
|
|
You might want to disable this after a run.
|
|
|
|
_Only use when you know what you are doing!_
|
|
|
|
## TODO
|
|
|
|
- Get the panel integration working (if this is possible)
|
|
- Use some official base image (maybe running the buanet dockerfile onto office image work)
|
|
|
|
## Technical notes
|
|
|
|
The `buanet` docker image contains some pretty useful startup script.
|
|
|
|
To ensure data stays persistent across restarts I simply softlink `/data` to `/opt/iobroker`.
|
|
I removed some check that was not compatible with the symlink and not needed in our case.
|
|
I added the unmodified version as a reference.
|
|
|
|
[1]: https://github.com/MaxWinterstein/homeassistant-addons/issues/21
|