Skip to content
Troy Prelog edited this page Aug 12, 2022 · 51 revisions

⚠️ Home Assistant only supports Linux, OSX and Windows using WSL. FreeBSD is not supported. This plugin runs in a FreeBSD jail, therefore it is not supported. Some integrations will not work as expected!

⚠️ In light of recent changes to Home Assistant, I’ve decided to have this removed from the community plugins on TrueNAS CORE. As Home Assistant continues to grow and add new features, installation on FreeBSD no longer “just works” as it had for so many years in the past. I will leave this artifact repo on GitHub for those who wish to continue using the plugin or add the files to a regular jail. However, I can not leave this so easily accessible when Home Assistant’s own default configuration no longer works as expected. Existing plugin installations will continue to work and can be maintained as you would any regular jail.

⚠️ This plugin provides a scripted installation of Home Assistant Core. This is considered an advanced installation method, using this plugin will not be an exception. This plugin does not provide a fully managed system like Home Assistant OS. There is no Supervisor hence addons are not available. Manual intervention and use of the command line will be required!

⚠️ This plugin is not actively maintained. At this time I am no longer using TrueNAS CORE or any iocage jails. As a consequence I may not be aware of, and proactively fixing any issues that could arise. If you're having trouble with the installation of this plugin you can still open an issue and I will do my best to help. While no further development is currently planned I will continue trying to support this plugin for as long as it remains feasible.


This plugin will create an iocage jail for Home Assistant Core

  • Home Assistant Core will be installed using a Python Virtualenv
  • Updates for Home Assistant are performed using the jail's console
  • Also includes options to create separate Python Virtualenvs for the following
  • A separate directory for each virtualenv ( service ) will be created under /usr/local/share
  • The plugin's provided services run as non-root user homeassistant with a uid of 8123
  • Separate configuration directories for each service are located in /home/homeassistant

This plugin provides these basic configuration files to help get started

ℹ️ A simple console menu is provided to help with basic tasks

Home Assistant Community