Add option 'eval'

ioBroker/DOCS.md

@@ -0,0 +1,51 @@
+# 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