home-assistant.io/source/developers/hassio/addon_testing.markdown
Ville Skyttä b39bd81c6e Spelling fixes (#4532)
* Spelling fixes

* "It's" -> "its" fixes

* Fix capitalization of "Pi" in "Raspberry Pi"

"Pi", not "PI" or "pi".
2018-01-28 22:28:56 +01:00

1.6 KiB

layout, title, description, date, sidebar, comments, sharing, footer, redirect_from
layout title description date sidebar comments sharing footer redirect_from
page Local add-on testing Instructions on how to test your add-on locally. 2017-04-30 13:28 true false true true /hassio/addon_testing/

The fastest way to develop add-ons is by adding them to your local add-on repository. To access your local add-on repository, install either the Samba add-on or SSH add-on.

Right now add-ons will work with images that are stored on Docker Hub (using image from add-on config). Without image inside local add-ons repository it to be built on the device.

{% linkable_title Local build %}

You can build and try the addon on your developer machine also. Move all addon stuff into a temp folder. If you use FROM $BUILD_FROM you need set a base image with build args. Normally you can use follow base images:

  • armhf: homeassistant/armhf-base:latest
  • aarch64: homeassistant/aarch64-base:latest
  • amd64: homeassistant/amd64-base:latest
  • i386: homeassistant/i386-base:latest

Use docker to build the test addon: docker build --build-arg BUILD_FROM="homeassistant/amd64-base:latest" -t local/my-test-addon .

{% linkable_title Local run %}

Create a new folder for data and add a test options.json file. After that you can run your add-on with: docker run --rm -v /tmp/my_test_data:/data -p PORT_STUFF_IF_NEEDED local/my-test-addon

{% linkable_title Logs %}

All stdout and stderr are redirected to the Docker logs. The logs can be fetched from the add-on page inside the Hass.io panel in Home Assistant.