{"id":13588186,"url":"https://github.com/home-assistant/supervised-installer","last_synced_at":"2025-12-30T00:18:44.420Z","repository":{"id":38995757,"uuid":"183216119","full_name":"home-assistant/supervised-installer","owner":"home-assistant","description":"Installer for a generic Linux system","archived":false,"fork":false,"pushed_at":"2025-03-06T03:42:04.000Z","size":187,"stargazers_count":1827,"open_issues_count":2,"forks_count":598,"subscribers_count":69,"default_branch":"main","last_synced_at":"2025-04-03T10:41:24.940Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/home-assistant.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://www.openhomefoundation.org"}},"created_at":"2019-04-24T11:35:39.000Z","updated_at":"2025-03-31T19:57:35.000Z","dependencies_parsed_at":"2023-01-31T02:40:12.736Z","dependency_job_id":"db66b2e8-3b78-4b26-841d-d9301f327b09","html_url":"https://github.com/home-assistant/supervised-installer","commit_stats":{"total_commits":182,"total_committers":46,"mean_commits":"3.9565217391304346","dds":0.6868131868131868,"last_synced_commit":"4ce4bad3fa1ca2d61f758284bc8a14eba580ebc9"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/home-assistant%2Fsupervised-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/home-assistant%2Fsupervised-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/home-assistant%2Fsupervised-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/home-assistant%2Fsupervised-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/home-assistant","download_url":"https://codeload.github.com/home-assistant/supervised-installer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281415,"owners_count":21077423,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest"],"created_at":"2024-08-01T15:06:33.456Z","updated_at":"2025-12-30T00:18:44.415Z","avatar_url":"https://github.com/home-assistant.png","language":"Shell","funding_links":["https://www.openhomefoundation.org"],"categories":["Shell"],"sub_categories":[],"readme":"\u003e [!WARNING]\n\u003e This installation method is unsupported with the Home Assistant OS 2025.12.0\n\u003e release. See the [Deprecating Core and Supervised installation methods, and 32-bit systems](https://www.home-assistant.io/blog/2025/05/22/deprecating-core-and-supervised-installation-methods-and-32-bit-systems/)\n\u003e blog post for more information.\n\n\n\u003e [!IMPORTANT]\n\u003e This installation method is for advanced users only!\n\u003e\n\u003e The Supervised Debian installation is an opinionated appliance. That means it has\n\u003e many dependencies and bundles default configuration files for system services!\n\u003e\n\u003e Make sure you understand [the requirements](https://github.com/home-assistant/architecture/blob/master/adr/0014-home-assistant-supervised.md).\n\n# Install Home Assistant Supervised\n\nThis installation method provides the full Home Assistant experience on a regular operating system. This means, all components from the Home Assistant method are used, except for the Home Assistant Operating System. This system will run the Home Assistant Supervisor. The Supervisor is not just an application, it is a full appliance that manages the whole system. It will clean up, repair or reset settings to default if they no longer match expected values.\n\nBy not using the Home Assistant Operating System, the user is responsible for making sure that all required components are installed and maintained. Required components and their versions will change over time. Home Assistant Supervised is provided as-is as a foundation for community supported do-it-yourself solutions. We only accept bug reports for issues that have been reproduced on a freshly installed, fully updated Debian with no additional packages.\n\nThis method is considered advanced and should only be used if one is an expert in managing a Linux operating system, Docker and networking.\n\n\n\n## Installation\n\nRun the following commands as root (`su -` or `sudo su -` on machines with sudo installed):\n\nStep 1: Transition from the default Debian networking service `ifupdown` to NetworkManager and systemd-resolved, run the following commands:\n\n```bash\napt install \\\nnetwork-manager \\\nsystemd-resolved\n```\n\nAt this point you won't have Internet access because systemd-resolved doesn't know about your DNS setup. To restore Internet, we need to fully transition the network setup to NetworkManager. There was a hint in the output of the previous command:\n```\nThe following network interfaces were found in /etc/network/interfaces\nwhich means they are currently configured by ifupdown:\n- enp1s0\nIf you want to manage those interfaces with NetworkManager instead\nremove their configuration from /etc/network/interfaces.\n```\n\nThe network interface name might be different depending on your setup. For a default network setup using DHCP the following commands work:\n\n```bash\nsystemctl restart systemd-resolved.service \u0026\u0026 \\\nsystemctl disable --now networking.service \u0026\u0026 \\\nmv /etc/network/interfaces /etc/network/interfaces.disabled \u0026\u0026 \\\nsystemctl restart NetworkManager\n```\n\n\u003e [!NOTE]\n\u003e Your system might have a new IP address at this point, probably because the DHCP server id used by NetworkManager appears to be different.\n\nStep 2: Install Docker-CE, OS Agent and Supervised dependencies which aren't part of the package dependencies with this command:\n\n```bash\napt install \\\ncurl \\\nudisks2\n```\n\nStep 3: Install Docker-CE with the following command:\n\n```bash\ncurl -fsSL get.docker.com | sh\n```\n\nStep 4: Install the OS-Agent:\n\nInstructions for installing the OS-Agent can be found [here](https://github.com/home-assistant/os-agent/tree/main#using-home-assistant-supervised-on-debian)\n\nStep 5: Install the Home Assistant Supervised Debian Package:\n\n```bash\ncurl -L -o homeassistant-supervised.deb https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb\napt install ./homeassistant-supervised.deb\n```\n\n## Supported Machine types\n\n- generic-x86-64\n- odroid-c2\n- odroid-c4\n- odroid-n2\n- qemuarm-64 (use this for any aarch64 machine)\n- qemux86-64\n- raspberrypi3-64\n- raspberrypi4-64\n- raspberrypi5-64\n- khadas-vim3\n\n## Configuration\n\nThe default path for our `$DATA_SHARE` is `/var/lib/homeassistant` (used to be `/usr/share/hassio`).\nThis path is used to store all home assistant related things.\n\nYou can reconfigure this path during installation with\n\n```bash\nDATA_SHARE=/my/own/homeassistant dpkg --force-confdef --force-confold -i homeassistant-supervised.deb\n```\n\n## Troubleshooting\n\nIf something's going wrong, use `journalctl -f` to get your system logs. If you are not familiar with Linux and how you can fix issues, we recommend to use our Home Assistant OS.\n\n[![Home Assistant - A project from the Open Home Foundation](https://www.openhomefoundation.org/badges/home-assistant.png)](https://www.openhomefoundation.org/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhome-assistant%2Fsupervised-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhome-assistant%2Fsupervised-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhome-assistant%2Fsupervised-installer/lists"}