# Ha-fusion

Ha-fusion is a custom, alternative frontend for the Home Assistant dashboard. It is open source and self-hosted, installable on Unraid and Umbrel.

Canonical page: https://ourlocalhost.com/app/2872/ha-fusion

## Description

HA-Fusion is a custom, alternative frontend for the Home Assistant dashboard. Inspired by the iOS Home app, it aims to provide a modern, easy-to-use, performant, and highly customisable interface. It focuses on visual appeal and enhancing the Home Assistant experience.

## Platform availability

Available on 2 of 10 platforms: Unraid, Umbrel.

## Health score

58/100 (Fair), based on 5 of 5 factors.
- Maintained: 62 (last commit 137 days ago)
- Popular: 70 (3,020 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)
- Security check: 84 (no serious findings, 1 minor, CI)

## Links

- Unraid: https://ca.unraid.net/apps/ha-fusion-008zko01deiml8?q=ha-fusion
- Umbrel: https://apps.umbrel.com/app/home-assistant-fusion-ui

## Common questions

### How do I migrate from the original ha-fusion repository to the maintained fork?

Use the fork repository knowald/ha-fusion and the matching add-on repository knowald/addon-ha-fusion. The fork README includes a short migration guide.

### How do I install and update ha-fusion with Docker Compose?

Place an edited docker-compose.yml in a suitable directory and run docker-compose up -d ha-fusion. To update, run docker-compose pull ha-fusion and then docker-compose up -d ha-fusion.

### How do I point a standalone ha-fusion container to my Home Assistant instance?

Set the HASS_URL environment variable to your Home Assistant instance. The container example also exposes port 5050.

### Where should ha-fusion Docker data be mounted?

Bind mount the host data directory to /app/data in the container, such as -v /path/to/ha-fusion:/app/data.

### How can I open a specific dashboard view or hide the menu with URL parameters?

Append ?view=ViewName or ?menu=false to the URL. Query strings work only when a port is exposed in the add-on configuration or Docker, not when using Ingress.

---
Source: Our Local Host (https://ourlocalhost.com/app/2872/ha-fusion), the self-hosted and open-source app directory.
