HACS and Customization

What Is HACS and How to Install It in Home Assistant

HACS is a community-run store for Home Assistant integrations, dashboard cards and themes. This guide explains what it does and how to install it.

On this page
  1. What is HACS for?
  2. What HACS is not
  3. Before you install
  4. Install HACS on Home Assistant OS
  5. Install HACS on Container or Core
  6. Turn on the HACS integration
  7. Why HACS asks you to sign in to GitHub
  8. Home Assistant 2026.11 and later
  9. Does HACS still exist?
  10. Next steps
  11. Safety

HACS (Home Assistant Community Store) is a community project that lets you find, install and update custom content from inside Home Assistant. It is not part of Home Assistant core, and the Home Assistant team does not review or support what it installs.

What is HACS for?

HACS gives you a screen to download, update and remove custom content hosted on GitHub. The content types include:

  • Integrations, which are added to the custom_components folder
  • Dashboard cards and plugins, which are stored under www/community
  • Themes
  • Python scripts, AppDaemon apps and templates

HACS keeps a default list of repositories. Anything outside that list can be added as a custom repository from the three-dot menu, under Custom repositories, by entering a URL and choosing a type.

What HACS is not

  • It is not an official Home Assistant feature. It is a separate community project.
  • It is not an add-on. HACS is a custom integration. On Home Assistant OS, the “Get HACS” add-on is only the installer. You can read more about the difference in our guide to Home Assistant add-ons.
  • A listing is not a security audit. HACS checks that a repository has the right structure. It does not review what the code does.

Before you install

You need:

  • A free GitHub account
  • A working Home Assistant install
  • Access to your configuration folder, through an add-on, SSH or a terminal

Take a backup before you start. Custom integrations run with full access to your Home Assistant instance.

Install HACS on Home Assistant OS

  1. Go to Settings > Apps (older releases call this Add-ons) and open the app store.
  2. Open the three-dot menu in the top-right corner and select Repositories.
  3. Add https://github.com/hacs/addons and save.
  4. Find Get HACS, select Install, then select Start.
  5. Open the Log tab, read the completion message, and restart Home Assistant.

Install HACS on Container or Core

Open a shell in your Home Assistant configuration directory (or inside the container if you run Home Assistant in Docker) and run:

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

Then restart Home Assistant.

Turn on the HACS integration

After the restart:

  1. Go to Settings > Devices & services and select Add integration.
  2. Search for HACS, select it, tick each acknowledgment, and select Submit.
  3. Open https://github.com/login/device, enter the one-time code HACS shows you, and authorize the HACS app on GitHub.
  4. Return to Home Assistant and select Finish.

HACS should then appear in the sidebar. If it doesn’t, refresh your browser.

Why HACS asks you to sign in to GitHub

HACS uses the GitHub API to read repositories, and it does this with your token. A signed-in account gets a higher request limit, which is 5,000 requests an hour. Large first loads can briefly hit rate limits, so wait a few minutes and try again if HACS stalls.

Home Assistant 2026.11 and later

Some recent coverage says Home Assistant 2026.11 brings HACS into the core app as a built-in Marketplace under Settings. The steps above describe the classic HACS install. We have not been able to confirm the 2026.11 details, so check the official Home Assistant 2026.11 release notes to see what your version includes before you follow the steps. What happened to HACS covers the history in more detail.

Does HACS still exist?

Yes. HACS was not shut down, and it is still maintained as a separate community project. For the recent changes, see what happened to HACS.

Next steps

Once HACS is running:

Integrations you download in HACS need a restart before they appear under Settings > Devices & services.

Safety

Custom integrations have full access to your Home Assistant instance. Install only from repositories you trust, and take a backup before you install or update anything.

Keep exploring

Guides from other topics

All topics →