Skip to content

Update add-on to app terminology per hacs/addons#37 #669

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
frenck merged 3 commits into from
Feb 5, 2026
+11 −11
Merged

Update add-on to app terminology per hacs/addons#37 #669

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
08dfcb7
Initial plan
Copilot Jan 29, 2026
fb864fc
Update documentation to change add-on to app terminology per hacs/add…
Copilot Jan 29, 2026
1605386
Update add-on to app terminology consistently per frenck's review
Copilot Feb 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions source/docs/faq/addons.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
---
id: addons
title: Add-ons?
description: 'NO, no, nope, this is not an add-on, and does not handle add-ons'
title: Apps?
description: 'NO, no, nope, this is not an app, and does not handle apps'
---

- HACS is an [integration](https://www.home-assistant.io/glossary/#integration), and not an [add-on](https://www.home-assistant.io/glossary/#add-on)
- HACS does not handle [add-ons](https://www.home-assistant.io/glossary/#add-on).
- HACS is an [integration](https://www.home-assistant.io/glossary/#integration), and not an [app](https://www.home-assistant.io/glossary/#app)
- HACS does not handle [apps](https://www.home-assistant.io/glossary/#app).

[Add-ons](https://www.home-assistant.io/glossary/#add-on) and HACS has nothing to do with each other, they are completely different.
[Apps](https://www.home-assistant.io/glossary/#app) and HACS has nothing to do with each other, they are completely different.

## The exception

With all rules, there will be exceptions at some point.

For HACS and add-ons that is now the [Get HACS add-on](https://github.com/hacs/addons) that was made for Home Assistant Operating System and Supervised to simplify the initial download of HACS itself.
For HACS and apps that is now the [Get HACS app](https://github.com/hacs/addons) that was made for Home Assistant Operating System and Supervised to simplify the initial download of HACS itself.
8 changes: 4 additions & 4 deletions source/docs/use/download/download.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,15 @@ How you download HACS depends on your Home Assistant installation type. In the i

=== "OS/Supervised"

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

1. To add the HACS add-on repository to your Home Assistant, select this [my link](https://my.home-assistant.io/redirect/supervisor_addon/?addon=cb646a50_get&repository_url=https%3A%2F%2Fgithub.com%2Fhacs%2Faddons).
- When prompted to confirm if you want to open the page in Home Assistant, check if the URL is correct. Then, select **Open link**.
- In the **Missing add-on repository** dialog, select **Add**.
- You have now added the repository that allows you to download HACS to Home Assistant.
2. In the **Get HACS** add-on, select **Install**.
3. **Start** the add-on.
4. Navigate to the add-on logs and follow the instructions given there.
2. In the **Get HACS** app, select **Install**.
3. **Start** the app.
4. Navigate to the app logs and follow the instructions given there.

=== "Container"

Expand Down
2 changes: 1 addition & 1 deletion source/docs/use/download/prerequisites.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Before you start using HACS, make sure the following requirements are met:
- You have [access to the file system](https://www.home-assistant.io/docs/configuration/#to-set-up-access-to-the-files-and-prepare-an-editor) where the Home Assistant configuration files are located.
- You know how to access the Home Assistant log file.
- You know how to [enable debug logging](https://www.home-assistant.io/docs/configuration/troubleshooting/#debug-logs-and-diagnostics).
- You are aware that although you can use an add-on to download HACS, HACS itself is not an add-on, and does not contain any [add-ons](https://www.home-assistant.io/docs/glossary/#add-on).
- You are aware that although you can use an app to download HACS, HACS itself is not an app, and does not contain any [apps](https://www.home-assistant.io/docs/glossary/#app).
- You have a stable internet connection, sufficient bandwidth, and no data caps.
- You are not blocking outgoing requests to GitHub or Cloudflare.
- For more information, refer to the documentation under [**FAQ** > **Data sources**](/docs/faq/data_sources.md).