# home-assistant/supervised-installer

Installer for a generic Linux system

Repository: https://github.com/home-assistant/supervised-installer
Canonical: https://ross.abutalabs.com/products/supervised-installer
Language: Shell
License: Apache-2.0
License Family: permissive
Topics: hacktoberfest
Last push: 2026-08-03T08:57:42+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 51, longevity 100
- inputs: {"age_days": 2688, "days_push": 30, "days_rel": 247, "gap_med": 87.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1932, forks 626 (observed 2026-08-28T04:05:56.250333+00:00)

## What it is
A shell-based installer that sets up Home Assistant Supervised on a generic Debian Linux system, providing the full Home Assistant experience including the Supervisor without the Home Assistant Operating System. It is an opinionated appliance installer intended for advanced users who manage their own Linux, Docker, and networking stack.

## Use cases
- install home assistant supervised on debian
- run home assistant supervisor on generic linux
- set up home assistant without home assistant os
- self-host home assistant on my own debian server
- convert a debian machine into a home assistant appliance
- install home assistant with add-ons on plain linux

## When to choose
- you are an expert with Debian, Docker, and networking and want full Home Assistant including Supervisor and add-ons on your own hardware
- you need Home Assistant Supervised on a generic x86/Debian system instead of the dedicated OS
- you want a community-supported DIY Home Assistant foundation you fully control

## When to avoid
- you just want Home Assistant with minimal effort - use Home Assistant OS or the container image instead
- you are not comfortable managing Linux system services, networking, and Docker yourself
- you need official support - this installation method is deprecated and unsupported as of Home Assistant OS 2025.12.0

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: deployment, self-hosted, developer-tools
- domain: self-hosted, iot
- platform: linux
- tags: home-assistant, supervisor, installer, debian, appliance, deprecated-install-method, automation, linux, shell, docker

## Member repositories
- home-assistant/supervised-installer (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:56.250333+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:08:40.941801+00:00, confidence not recorded.
  - readme: https://github.com/home-assistant/supervised-installer (fetched 2026-08-28T04:05:56.250333+00:00, sha 54e857771f70)
- Data as of 2026-08-30T08:39:29.467469+00:00.