Skip to content

Downloading HACS

This section shows how to download HACS to your Home Assistant and how to troubleshoot some common issues.

To download HACS

How you download HACS depends on your Home Assistant installation type. In the instructions below, select the tab that matches your installation type (OS/Supervised, Container, or Core).

Warning

If you don't know what type of Home Assistant installation you are running, you should not use HACS (or any other custom integration).

For Home Assistant Operating System and Supervised, there is an app for downloading HACS. To add the custom app repository that allows you to get this app, follow these steps.

  1. Add the HACS app repository to your Home Assistant.
  2. Go to Settings > Apps > Install app and select Get HACS. Then select Install.
  3. Start the app.
  4. Navigate to the app logs and follow the instructions given there.

To set up HACS, you can use the HACS download script.

  1. Open a terminal.
  2. Go inside the container with docker exec -it <name of the container running homeassistant> bash.

  3. Run the HACS download script.

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

To set up HACS, you can use the HACS download script.

  1. Open a terminal.
  2. Change to the user that is running Home Assistant.

  3. Run the HACS download script.

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

Finalizing steps

  1. Restart Home Assistant.
  2. Follow the steps on setting up the HACS integration.

Troubleshooting

  • Is Ctrl+V not working for you?
    • Try Ctrl+Shift+V instead
    • Try Ctrl+Ins SHIFT+INS(insert) instead
    • Try Right-click instead

Help and support

Resources

Code of Conduct
Made with Material for MkDocs

Help us make these docs great!

All HACS docs are open source. See something that's wrong or unclear? Submit a pull request.

Edit this page on GitHub
Learn how to contribute

Still need help?