Skip to content

Commit

Permalink
Update: add option to update from dashboard (#564)
Browse files Browse the repository at this point in the history
  • Loading branch information
c0ffeeca7 authored Aug 22, 2024
1 parent 2b1c4cf commit d84842e
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 5 deletions.
5 changes: 3 additions & 2 deletions source/docs/use/repositories/dashboard.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This section shows you how to use the HACS dashboard.
- Each line in the data table represents a community repository that can be downloaded via HACS.
![nav_overview](/assets/images/screenshots/overview/base/light.png#only-light)
![nav_overview](/assets/images/screenshots/overview/base/dark.png#only-dark)
2. To browse the repositories, use the [search](#search-repositories) and [filter](#filter-repositories) functions.
2. To browse the repositories, use the [search](#search-repositories) and [filter](#filtering-repositories) functions.
- The HACS dashboard uses the same [table features](https://www.home-assistant.io/docs/organizing/filtering) used elsewhere in Home Assistant.
- By default, the dashboard shows the repositories you have downloaded with HACS on top of the list.
3. To view the repository documentation, the select the 3 dots :material-dots-vertical: menu, then select **Show details**.
Expand All @@ -35,7 +35,7 @@ You can search for both downloaded and available repositories in HACS.
![nav_overview](/assets/images/screenshots/overview/search/light.png#only-light)
![nav_overview](/assets/images/screenshots/overview/search/dark.png#only-dark)

## Filter repositories
## Filtering repositories

1. To define filters, next to the searchbar, select the (:material-filter-variant:) **Filters** button.

Expand All @@ -45,6 +45,7 @@ You can search for both downloaded and available repositories in HACS.

- **Type**: filters for a specific [type](/docs/use/repositories/type/index.md) of custom element: integration, dashboard, theme, template, AppDaemon app, or Python Script.
- **Status**:
- **Pending update**: There is a new version available for this repository. To download it, select **Redownload**.
- **Pending restart**: The repository has been downloaded. But for the software version to become active, you need to restart Home Assistant.
- Repositories with a pending restart generate a repair issue under [**System** > **Updates**](https://my.home-assistant.io/redirect/updates/). You can restart directly from there.
- **New**: HACS found repositories it has not seen before. If you select **Dismiss new**, these will be shown under **Available for download**.
Expand Down
10 changes: 7 additions & 3 deletions source/docs/use/update.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,11 @@ However, if you want to immediately check if something has changed for a reposit
These steps assume that you have already downloaded a repository. Follow these steps to update to a new software version of this repository.

1. [Create a backup](/docs/use/data.md/#creating-a-backup) and download that backup to another device.
2. If you have already downloaded a repository, you will get an update notification under <!-- hacs:my updates title="**{{coreui('panel.config')}}** > **{{coreui('ui.panel.config.updates.caption')}}**" -->.
- Open the notification and read the release notes.
- Select **Install**.
2. There are 2 ways to install an update for a repository:
- **Option 1**: From the update notification under <!-- hacs:my updates title="**{{coreui('panel.config')}}** > **{{coreui('ui.panel.config.updates.caption')}}**" -->.
- Open the notification and read the release notes.
- Select **Install**.
- **Option 2**: From the HACS dashboard.
- The repositories with updates have status **Pending update**.
- Select the 3 dots :material-dots-vertical: menu, then select **Redownload**.
3. If the repository is an integration, [restart Home Assistant](https://www.home-assistant.io/docs/configuration/#reloading-the-configuration-to-apply-changes).

0 comments on commit d84842e

Please sign in to comment.