Skip to content

Installation

Running AppDaemon requires using a configuration directory, which contains the appdaemon.yaml file. See the config section for more information.

Methods

HASS Add-on

The most common way of runnning AppDaemon is with a Home Assistant Community Add-on, which are docker containers that are managed by HAOS or the supervisor.

The configuration page in the Home Assistant interface has options for installing any additional dependencies your apps may require.

The configuration directory is available at /addon_configs/<container id>_appdaemon. Normally this is accessed via a samba share, provided by another add-on, that's mounted somewhere that the files can be easily edited.

Docker

Docker provides the ability to package and run an application in a loosely isolated environment called a container.

Docker images for AppDaemon are automatically created and made available on DockerHub. Platforms with different CPU architectures require different images, and currently the following architectures are supported:

  • linux/arm/v6
  • linux/arm/v7
  • linux/arm64/v8
  • linux/amd64

pip

AppDaemon can be installed into any environment

Install into python environment
pip install appdaemon

uv

Add to project
uv add appdaemon

Dependencies

There are several ways to install python packages, depending on the installation environment.

System Dependencies

Many python packages can be installed directly from the alpine repos. Search for the

Add package names to the add-on configuration page in the Home Assistant UI. Packages are installed with a apk install ... command every time the add-on starts.

Add package names to system_packages.txt.

None