Home assistant

How to Install HACS on Home Assistant (2026.11 Marketplace Update)

On this page
    TL;DR: On Home Assistant 2026.11 and newer, you do not install HACS anymore. It is built in as the Marketplace under Settings > Marketplace, and existing HACS setups migrate on their own. On 2026.10 and older, install HACS with the Get HACS app (Home Assistant OS) or the download script (Container and Core), restart, add the HACS integration under Settings > Devices & services and sign in with GitHub.

    Updated November 2026. This guide changed a lot this month. Home Assistant 2026.11 (stable release scheduled for November 4, 2026) folds HACS into Home Assistant itself as a built-in Marketplace. Below you will find both paths: what to do on 2026.11 and newer, and the classic install for anyone still on 2026.10 or older.

    HACS (Home Assistant Community Store) is where the community publishes integrations (connectors between Home Assistant and a device or service), dashboard cards, themes and templates that are not part of Home Assistant itself. If you have ever wanted a card like Mushroom or an integration for a niche local service, this is where it lives. It is also how you get small niche integrations that will never be in the official store.

    Which version are you on

    Go to Settings > About and check the Core version. Then follow the section that matches:

    • 2026.11 or newer: skip to Using the built-in Marketplace. HACS can no longer be installed on these versions.
    • 2026.10 or older: follow the classic HACS install below. Once you update to 2026.11, everything you installed moves to the Marketplace automatically.

    To see your installation type (Home Assistant OS, Supervised, Container or Core), open Settings > System > Repairs, click the three-dot menu and choose System information. Most people run Home Assistant OS, the complete system you flash onto a Raspberry Pi or mini PC. Container means Home Assistant runs inside Docker, and Core is a manual Python install.

    Popular with Home Assistant usersHome Assistant GreenPlug-and-play Home Assistant box. The easiest way to start, no SD card.Check price on AliExpressSONOFF ZBDongle-E (Zigbee 3.0 USB)Cheap, well supported Zigbee coordinator for ZHA or Zigbee2MQTT.Check price on AliExpressAqara Motion Sensor P1 (Zigbee)Fast, long battery life motion sensor for lighting automations.Check price on AliExpress

    Using the built-in Marketplace (2026.11 and newer)

    1. Go to Settings > Marketplace. It sits in Settings and is visible to administrators only, not in the sidebar like HACS was.
    2. Search or filter for what you want: integrations, dashboard cards, themes or templates. The catalog is the same one HACS used.
    3. Open a project, pick a version if you need a specific one, and install it. You have to accept a warning first, because community code is not tested or supported by the Home Assistant project.
    4. For a new custom integration, restart Home Assistant if asked, then add it under Settings > Devices & services > Add integration like any other integration.

    You no longer need a GitHub account to browse, install or update catalog content. GitHub only comes into play if you add a custom repository that is not in the default catalog, through the Marketplace option to add a project by link.

    What happens to an existing HACS install when you update

    • Everything you installed through HACS stays installed and keeps getting updates. Entity IDs stay the same, so automations and dashboards keep working.
    • Your custom repositories and update entities move over, including their names, areas and labels.
    • The HACS integration itself is removed. Old /hacs bookmarks open the Marketplace.
    • Dashboard resources move to /local/community/. Old /hacsfiles/ paths still work, but if you manage resources in YAML you will see a warning and should update them.
    • Templates that use integration_entities('hacs') need to change to integration_entities('marketplace').
    • AppDaemon apps and Python scripts you downloaded through HACS keep running but are no longer updated. A repair issue lists the affected ones.

    Take a full backup before the update anyway. Our backup and recovery guide covers how to keep one off the machine.

    AliExpress deals

    Classic HACS install (Home Assistant 2026.10 and older)

    You need a free GitHub account for this method. GitHub is the website where the community code is stored. HACS uses it to download from GitHub without hitting rate limits.

    Home Assistant OS or Supervised: the Get HACS app

    Since Home Assistant 2026.2, add-ons are called apps. On older versions the same menu says Add-ons.

    1. Go to Settings > Apps (or Settings > Add-ons) and open the store.
    2. Click the three-dot menu in the top right, choose Repositories, paste https://github.com/hacs/addons and click Add.
    3. Find Get HACS in the store, open it and click Install.
    4. Click Start. It downloads HACS and stops by itself.
    5. Check the Log tab and follow any instructions there. When it says it finished, you can uninstall Get HACS. It is only a downloader.
    6. Restart Home Assistant from Settings > System, power icon, Restart Home Assistant.

    Home Assistant Container (Docker)

    docker exec -it homeassistant bash
    wget -O - https://get.hacs.xyz | bash -
    exit
    docker restart homeassistant

    Replace homeassistant with your container name if it is different.

    Home Assistant Core

    Switch to the user that runs Home Assistant and run the same script, then restart Home Assistant:

    wget -O - https://get.hacs.xyz | bash -

    Add the HACS integration and connect GitHub

    1. Hard refresh your browser with CTRL+SHIFT+R (CMD+SHIFT+R on Mac). Without this, HACS often does not show up in the list.
    2. Go to Settings > Devices & services, click Add integration and search for HACS.
    3. Tick the acknowledgment boxes and submit.
    4. Home Assistant shows a device code. Open github.com/login/device, sign in, enter the code and authorize HACS.
    5. Back in Home Assistant, click Finish. HACS appears in the sidebar.

    Troubleshooting

    • HACS is not in the integration list. Restart Home Assistant, then hard refresh the browser. That fixes it almost every time.
    • “HACS cannot be installed” on 2026.11. That is expected. Use Settings > Marketplace instead.
    • Get HACS is missing from the store. Check the repository URL (https://github.com/hacs/addons) and reload the page.
    • GitHub rejects the device code. Codes expire after a few minutes. Cancel and start the integration setup again for a fresh one.
    • A custom card broke after the 2026.11 update. Look for a YAML dashboard resource still pointing at /hacsfiles/ and switch it to /local/community/.
    • An integration from HACS stopped working after a Home Assistant update. This is the most common HACS problem and it is usually the custom integration, not HACS. Update it first. When my oref_alert integration broke after a Core upgrade, updating it through HACS was the fix.

    What to install first

    Good first picks are dashboard cards like Mushroom and card-mod, and integrations for local devices that have no official support. For ideas, see our must-have Home Assistant apps, the recommended first steps after installing Home Assistant and dashboard and wall panel ideas. Community code runs with full access to your Home Assistant, so stick to popular, maintained projects.

    Frequently Asked Questions

    Do I still need to install HACS in Home Assistant 2026.11?

    No. From 2026.11, HACS is built into Home Assistant as the Marketplace under Settings > Marketplace, and HACS itself can no longer be installed. Existing HACS installations migrate automatically on the first start after the update.

    Do I need a GitHub account for HACS or the Marketplace?

    For the classic HACS install on 2026.10 and older, yes, a free account is required. The built-in Marketplace does not need GitHub to browse, install or update catalog content. You only connect GitHub to add a custom repository by link.

    Will my HACS integrations and cards survive the update to 2026.11?

    Yes. Installed integrations, cards and themes stay in place and keep receiving updates through the Marketplace, with the same entity IDs. AppDaemon apps and Python scripts keep running but are no longer updated.

    Is HACS safe to use?

    HACS and the Marketplace are just the delivery mechanism. The content is community code that the Home Assistant project does not test, audit or support, so install popular, actively maintained projects and keep a recent backup.

    Does the wget install script still work?

    On Home Assistant Container and Core running 2026.10 or older, yes, wget -O – https://get.hacs.xyz | bash – is still the official method. On Home Assistant OS use the Get HACS app instead. On 2026.11 and newer, use the Marketplace.

    Related guides

    Ad

    About us

    The Home Smart Home Team

    One house and a Home Assistant setup that grew one device at a time. Everything here was set up in that house first, in plain steps, and when something breaks the fix ends up in a post.

    More about us

    1 comment

    1. Pingback: продажа котлов

    Leave a comment

    Your email address will not be published. Required fields are marked *

    This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

    Coming soon
    The ready-made Home Assistant dashboard
    One email when it's ready, with an early-bird price. No spam. Privacy