Skip to main content

Home Assistant

Home Assistant is a popular open-source platform for smart home automation, allowing you to control and automate devices and services in your home. Running Home Assistant in a Docker container provides a flexible and isolated environment for managing your smart home setup.

Architecture Overview​

Installation Instructions​

  1. Install Docker: Ensure Docker is installed on your system. Get Docker.

  2. Pull the Home Assistant Image:

    docker pull ghcr.io/home-assistant/home-assistant:stable

  3. Run the Home Assistant Container (replace <your-config-folder> with your actual path):

    docker run -d --name homeassistant \
      --restart=unless-stopped \
      -v <your-config-folder>:/config \
      --network=host \
      ghcr.io/home-assistant/home-assistant:stable

    • On Windows, you may need to use -p 8123:8123 instead of --network=host:

      docker run -d --name homeassistant ^
        --restart=unless-stopped ^
        -v <your-config-folder>:/config ^
        -p 8123:8123 ^
        ghcr.io/home-assistant/home-assistant:stable

    This command runs Home Assistant in detached mode, mounts your configuration folder, and exposes the web interface.

Configuration Options​

  • /config: Stores Home Assistant configuration files.
  • -p 8123:8123: Exposes the Home Assistant web interface on port 8123 (use if --network=host is not available).

You can set additional environment variables and options as needed (see the Home Assistant Docker documentation for more details).

Usage​

  • Access Home Assistant: Open your browser and go to http://localhost:8123.
  • Integrate Devices: Use the web UI to add integrations for your smart devices and services.
  • Automate: Create automations and scripts to control your home automatically.

Updating Home Assistant​

To update Home Assistant, stop the container, pull the latest image, and restart:

docker stop homeassistant
docker rm homeassistant
docker pull ghcr.io/home-assistant/home-assistant:stable
docker run -d --name homeassistant \
  --restart=unless-stopped \
  -v <your-config-folder>:/config \
  -p 8123:8123 \
  ghcr.io/home-assistant/home-assistant:stable

Conclusion​

Home Assistant in Docker gives you a powerful and flexible platform for home automation. With a wide range of integrations and a strong community, you can automate and control nearly every aspect of your smart