How to Configure Home Assistant on TrueNAS

Community Guides
,
1

:information_source: TrueNAS Applications (Apps ) are based on Docker Compose, which makes it easy to customize and add services to your NAS.

This guide covers installing the Home Assistant app on TrueNAS.

TrueNAS provides a Deployment Guide with step-by-step instructions to help users get started.

Prerequisites

  • TrueNAS 24.10 or newer installed

  • Application pool configured (Apps > Settings)

  • Dedicated dataset for Home Assistant data (recommended)

    1. HomeAssistant (parent dataset)

      a. config-storage
      b. media-storage
      c. data-storage

Pre-Installation Setup

  1. Create Storage Datasets

  2. Go to Storage > Pools

  3. Create parent dataset (i.e, HomeAssistant)

  4. Create three child datasets using the Apps Dataset Preset (i.e, config-storage, media-storage, and data-storage)

  5. Note the Run-As User

  6. Home Assistant typically runs as UID 0 (root)

Installation Steps

  1. Go to Apps > Discover Apps

  2. Search for and select Home Assistant, click install

  3. Configure application settings:

  4. Accept default Application Name or customize if desired

  5. Set a secure password in the Database Password field (this is the password Home Assistant uses to connect to your TrueNAS system)

  6. Use a Host Path (Path that already exists on the system) storage configuration type and Enable ACL

  7. Map your three child datasets from the Pre-Installation Setup section to the appropriate storage volumes

  8. Use default Web Port 30027 or customize if needed

  9. Accept default Certificate and Resource options

Post-Installation

  1. Access Home Assistant via the Web UI button when the app status shows as running.
  2. Complete initial Home Assistant setup.
  3. Create admin login credentials.

This method provides the containerized Home Assistant Core with integrated TrueNAS management and proper dataset organization.