Skip to content
Closed
Show file tree
Hide file tree
Changes from 22 commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
723c63a
Remove deprecated hass tool documentation page (#41701)
Copilot Nov 24, 2025
937e8c3
Fix command_line binary sensor examples with correct payload values (…
Copilot Nov 24, 2025
4747adc
Drop Debian 12 from list of supported operating systems (#41936)
agners Nov 24, 2025
ab76279
Add new distributors (#41939)
mrdarrengriffin Nov 24, 2025
20ee863
Update Mauser logo (#41941)
mrdarrengriffin Nov 24, 2025
0c3424c
Add getting started section to calendar docs (#41839)
mik-laj Nov 24, 2025
20f6f5b
Merge distributor regions (#41942)
mrdarrengriffin Nov 24, 2025
6f6d69e
Container installation: add note about add-ons (#41945)
c0ffeeca7 Nov 24, 2025
adbdf49
Media source: remove mention of supervised, as it is deprecated (#41946)
c0ffeeca7 Nov 24, 2025
55e572d
Locked out: fix link (#41955)
c0ffeeca7 Nov 25, 2025
926d995
go2rtc: remove mention of Supervised (#41957)
c0ffeeca7 Nov 25, 2025
b2f76d6
FAQ file access, remove supervised (#41958)
c0ffeeca7 Nov 25, 2025
05a2900
Lacrosse: remove mention of supervised installation method (#41956)
c0ffeeca7 Nov 25, 2025
22d0622
Locked out: fix another link (#41959)
c0ffeeca7 Nov 25, 2025
96151a4
Logger: remove mention of Supervised (#41961)
c0ffeeca7 Nov 25, 2025
1ea0743
Z-Wave: remove mention of Supervised (#41960)
c0ffeeca7 Nov 25, 2025
148c145
Remove ZBT-2 buy now banner (#41963)
mrdarrengriffin Nov 25, 2025
eae6990
Terms and concepts, add-ons: remove Supervised (#41962)
c0ffeeca7 Nov 25, 2025
b61e089
ISAL: remove mention of Core installatioin type (#41964)
c0ffeeca7 Nov 25, 2025
01f0a72
Correct fail2ban integration docs (#41965)
edenhaus Nov 25, 2025
6e2f28a
Add rounding option for temperature values
flixlix Nov 25, 2025
27fe04b
Add supported_features to selector documentation with entity referenc…
Copilot Nov 25, 2025
bc86886
Update source/_dashboards/weather-forecast.markdown
flixlix Nov 25, 2025
32b33aa
build(deps-dev): bump addressable from 2.8.7 to 2.8.8 (#41983)
dependabot[bot] Nov 26, 2025
b907871
Update ChatGPT documentation (#41981)
balloob Nov 26, 2025
6fde22d
Add supported devices section to Music Assistant (#41979)
OzGav Nov 26, 2025
4f3e434
Document Matter integration requirements and support (#41829)
djansen1987 Nov 26, 2025
32f6f48
Update SmarterHome URL (#41988)
mrdarrengriffin Nov 26, 2025
aaf4e0b
Onvif: Clarified the need to have at least one H.264 video stream pre…
fencepost-error Nov 26, 2025
b4b4cad
build(deps-dev): bump webrick from 1.9.1 to 1.9.2 (#42001)
dependabot[bot] Nov 27, 2025
a8056b7
Update Feasycom product links in ibeacon markdown (#42003)
sevorl Nov 27, 2025
882c83c
Thread: migrate to a new adapter (#42007)
c0ffeeca7 Nov 27, 2025
4fcfdb0
Thread migration: add link to ZBT-2 documentation (#42010)
c0ffeeca7 Nov 27, 2025
220a37e
Thread: implement review feedback (#42011)
c0ffeeca7 Nov 27, 2025
79a7a8d
Clarify menu terminology in system health documentation (#42013)
jwillemsen Nov 28, 2025
875295f
alexa_devices: add link for alternatives (#41992)
jamesonuk Nov 28, 2025
c6b6672
Improve MQTT fan percentage state and command topic description (#42019)
jbouwh Nov 29, 2025
3f8135f
Remove Nest Guard example from Google Assistant SDK docs (#42024)
michaelmior Nov 29, 2025
f861f2b
Installation with Green: fix link to getting started procedure (#42037)
c0ffeeca7 Dec 1, 2025
07eb49f
Fix typos and enhance clarity in Times of the Day documentation (#42038)
marcjay Dec 1, 2025
403c685
Thread: add non-Home-Assistant-brand adapter to HA (#42041)
c0ffeeca7 Dec 1, 2025
d5c081d
build(deps-dev): bump multi_json from 1.17.0 to 1.18.0 (#42047)
dependabot[bot] Dec 2, 2025
18a388b
build(deps): bump express from 5.1.0 to 5.2.1 (#42045)
dependabot[bot] Dec 2, 2025
0d9e917
Installation on RPI: add RAM min req (#42049)
c0ffeeca7 Dec 2, 2025
1f03421
Thread: add third-party adapter: implement feedback (#42051)
c0ffeeca7 Dec 2, 2025
cf30607
Document installation parameters for SFR Box (#42053)
epenet Dec 2, 2025
03baa04
Merge branch 'home-assistant:current' into patch-1
flixlix Dec 2, 2025
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
6 changes: 6 additions & 0 deletions source/_dashboards/weather-forecast.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,8 @@ Forecast type:
description: Select the forecast to display between "Daily", "Hourly" and "Twice daily".
Secondary Info Attribute:
description: Here you can specify a secondary attribute to show under the current temperature. Ex. Extrema, Precipitation, Humidity. If not set, it will default to Extrema (High/Low) if available, if not available then Precipitation and if precipitation isn't available then Humidity.
Copy link

Copilot AI Nov 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use "for example" or "like" instead of "Ex." to improve readability and follow documentation standards. Should be: "...under the current temperature, for example, Extrema, Precipitation, or Humidity."

Copilot generated this review using guidance from repository custom instructions.
Round temperature:
description: Check this if you would like to round all temperature values in the card to its nearest integer.
Theme:
description: Name of any loaded theme to be used for this card. For more information about themes, see the [frontend documentation](/integrations/frontend/).
{% endconfiguration_basic %}
Expand Down Expand Up @@ -80,6 +82,10 @@ secondary_info_attribute:
description: Which attribute to display under the temperature.
type: string
default: Defaults to `extrema` if available, if not available then `precipitation` and if precipitation isn't available then `humidity`.
round_temperature:
required: false
description: Round temperature values to closest integer.
default: `false` (uses the raw temperature values).
theme:
required: false
description: Override the used theme for this card with any loaded theme. For more information about themes, see the [frontend documentation](/integrations/frontend/).
Expand Down
5 changes: 3 additions & 2 deletions source/_data/glossary.yml
Original file line number Diff line number Diff line change
Expand Up @@ -296,8 +296,9 @@
- groups
- term: HASS
definition: >-
HASS or [hass](/docs/tools/hass/) is often used as an abbreviation for Home
Assistant. It is also the command-line tool.
HASS is an abbreviation for Home Assistant that was commonly used in the past.
This abbreviation is no longer actively used. It is recommended to use the full
name "Home Assistant" instead of abbreviations.
- term: HassOS
definition: >-
Another name for Home Assistant Operating System
Expand Down
100 changes: 77 additions & 23 deletions source/_data/products.yml
Original file line number Diff line number Diff line change
@@ -1,25 +1,30 @@
green:
name: "<strong>Home Assistant Green</strong>"
distributors:
# America
# North America
- name: Amazon US
ship_from: US
ship_to: America
ship_to: North America
url: https://www.amazon.com/dp/B0CXVKSG19?maas=maas_adg_BB51722E249D328CABB2F6DF1F8976CC_afap_abs&ref_=aa_maas&tag=maas
logo: /images/distributors/amazon.webp
- name: Apollo Automation
ship_from: US & Canada
ship_to: North America
url: https://apolloautomation.com/products/home-assistant-green
logo: /images/distributors/apollo.webp
- name: ameriDroid
ship_from: US
ship_to: America
ship_to: North America
url: https://ameridroid.com/products/home-assistant-green
logo: /images/distributors/ameridroid.webp
- name: CloudFree
ship_from: US
ship_to: America
ship_to: North America
url: https://cloudfree.shop/product/home-assistant-green/
logo: /images/distributors/cloudfree.webp
- name: Seeed Studio
ship_from: US
ship_to: America
ship_to: North America
url: https://www.seeedstudio.com/Home-Assistant-Green-p-5792.html
logo: /images/distributors/seeed-studio.webp
# Asia
Expand Down Expand Up @@ -94,7 +99,7 @@ green:
ship_from: Portugal
ship_to: Europe
url: https://mauser.pt/catalog/product_info.php?products_id=095-3152
logo: /images/distributors/mauser.png
logo: /images/distributors/mauser.webp
- name: mediarath
ship_from: Germany
ship_to: Europe
Expand Down Expand Up @@ -160,18 +165,33 @@ green:
ship_to: Europe
url: https://www.inet.se/produkt/8310063/home-assistant-green
logo: /images/distributors/inet.webp
- name: Nettop
ship_from: Greece
ship_to: Europe
url: https://nettop.gr/index.php/smart-home/home-assistant/home-assistant-green.html
logo: /images/distributors/nettop.webp
- name: BerryBase
ship_from: Germany
ship_to: Europe
url: https://www.berrybase.de/detail/019a8296042d70f19cbbcb67ddc0b205
logo: /images/distributors/berrybase.webp
- name: SmartDomo
ship_from: Germany
ship_to: Europe
url: https://smartdomo.de/products/home-assistant-green
logo: /images/distributors/smartdomo.webp
yellow:
name: "<strong>Home Assistant Yellow</strong>"
distributors:
# America
# North America
- name: ameriDroid
ship_from: US
ship_to: America
ship_to: North America
url: https://ameridroid.com/products/home-assistant-yellow
logo: /images/distributors/ameridroid.webp
- name: CloudFree
ship_from: US
ship_to: America
ship_to: North America
url: https://cloudfree.shop/product/home-assistant-yellow/
logo: /images/distributors/cloudfree.webp
# Australia
Expand All @@ -194,20 +214,20 @@ yellow:
zbt-1:
name: "<strong>Home Assistant Connect ZBT-1</strong>"
distributors:
# America
# North America
- name: ameriDroid
ship_from: US
ship_to: America
ship_to: North America
url: https://ameridroid.com/products/skyconnect
logo: /images/distributors/ameridroid.webp
- name: CloudFree
ship_from: US
ship_to: America
ship_to: North America
url: https://cloudfree.shop/product/home-assistant-skyconnect/
logo: /images/distributors/cloudfree.webp
- name: Seeed Studio
ship_from: US
ship_to: America
ship_to: North America
url: https://www.seeedstudio.com/Home-Assistant-SkyConnect-p-5479.html
logo: /images/distributors/seeed-studio.webp
# Asia
Expand Down Expand Up @@ -267,7 +287,7 @@ zbt-1:
ship_from: Portugal
ship_to: Europe
url: https://mauser.pt/catalog/product_info.php?products_id=095-1222
logo: /images/distributors/mauser.png
logo: /images/distributors/mauser.webp
- name: mediarath
ship_from: Germany
ship_to: Europe
Expand Down Expand Up @@ -336,20 +356,25 @@ zbt-1:
voice-pe:
name: "<strong>Home Assistant Voice</strong> Preview Edition"
distributors:
# America
# North America
- name: ameriDroid
ship_from: US
ship_to: America
ship_to: North America
url: https://ameridroid.com/products/home-assistant-voice-preview-edition/
logo: /images/distributors/ameridroid.webp
- name: Apollo Automation
ship_from: US & Canada
ship_to: North America
url: https://apolloautomation.com/products/home-assistant-voice
logo: /images/distributors/apollo.webp
- name: CloudFree
ship_from: US
ship_to: America
ship_to: North America
url: https://cloudfree.shop/product/home-assistant-voice-preview-edition/
logo: /images/distributors/cloudfree.webp
- name: Seeed Studio
ship_from: US
ship_to: America
ship_to: North America
url: https://www.seeedstudio.com/Home-Assistant-Voice-p-6998.html
logo: /images/distributors/seeed-studio.webp
# Asia
Expand Down Expand Up @@ -409,7 +434,7 @@ voice-pe:
ship_from: Portugal
ship_to: Europe
url: https://mauser.pt/catalog/product_info.php?products_id=095-4747
logo: /images/distributors/mauser.png
logo: /images/distributors/mauser.webp
- name: SmarterHOME
ship_from: Slovakia
ship_to: Europe
Expand Down Expand Up @@ -455,10 +480,25 @@ voice-pe:
ship_to: Europe
url: https://www.robbshop.nl/home-assistant-voice-preview-edition
logo: /images/distributors/robb.webp
- name: Nettop
ship_from: Greece
ship_to: Europe
url: https://nettop.gr/index.php/smart-home/home-assistant/home-assistant-voice.html
logo: /images/distributors/nettop.webp
- name: BerryBase
ship_from: Germany
ship_to: Europe
url: https://www.berrybase.de/detail/019a8294e0e872c6a26a43c31d66e37a
logo: /images/distributors/berrybase.webp
- name: SmartDomo
ship_from: Germany
ship_to: Europe
url: https://smartdomo.de/products/home-assistant-voice-preview-edition-sprachassistent-nabu-casa-nc-vk-9727
logo: /images/distributors/smartdomo.webp
zwa-2:
name: "<strong>Home Assistant</strong> Connect ZWA-2"
distributors:
# America
# North America
- name: Amazon
ship_from: US
ship_to: North America
Expand Down Expand Up @@ -521,7 +561,7 @@ zwa-2:
ship_from: Portugal
ship_to: Europe
url: https://mauser.pt/catalog/product_info.php?products_id=095-6904
logo: /images/distributors/mauser.png
logo: /images/distributors/mauser.webp
- name: RaspberryPi.dk
ship_from: Denmark
ship_to: Europe
Expand Down Expand Up @@ -612,9 +652,23 @@ zwa-2:
ship_to: Europe
url: https://www.robbshop.nl/home-assistant-connect-zwa-2-z-wave-antenne
logo: /images/distributors/robb.webp
- name: Nettop
ship_from: Greece
ship_to: Europe
url: https://nettop.gr/index.php/smart-home/home-assistant/home-assistant-connect-zwa-2.html
logo: /images/distributors/nettop.webp
- name: BerryBase
ship_from: Germany
ship_to: Europe
url: https://www.berrybase.de/detail/019a8294957e72eeac488049bae6e5f7
logo: /images/distributors/berrybase.webp
- name: SmartDomo
ship_from: Germany
ship_to: Europe
url: https://smartdomo.de/products/z-wave-adapter-home-assistant-connect-zwa-2
logo: /images/distributors/smartdomo.webp
zbt-2:
name: "<strong>Home Assistant</strong> Connect ZBT-2"
new: true
distributors:
# North America
#- name: Amazon
Expand Down Expand Up @@ -739,7 +793,7 @@ zbt-2:
ship_from: Portugal
ship_to: Europe
url: https://mauser.pt/095-7567
logo: /images/distributors/mauser.png
logo: /images/distributors/mauser.webp
- name: WIFIShop
ship_from: Romania
ship_to: Europe
Expand Down
4 changes: 2 additions & 2 deletions source/_docs/locked_out.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,9 @@ You are the owner or administrator of Home Assistant and forgot your password.

If you are the owner or have administrator, there are different methods to reset a password, depending on your situation:

- [Reset a password while still logged in](#to-reset-a-password-while-still-logged-in-including-supervised)
- [Reset a password while still logged in](#to-reset-a-password-while-still-logged-in)
- [Reset an owner's password when logged out](#to-reset-an-owners-password-via-console)
- [reset a user's password, via the container command line](#to-reset-a-users-password-via-the-container-command-line)
- [Reset a user's password, via the container command line](#to-reset-a-users-password-via-the-container-command-line)

#### To reset a password while still logged in

Expand Down
36 changes: 0 additions & 36 deletions source/_docs/tools/hass.markdown

This file was deleted.

4 changes: 2 additions & 2 deletions source/_faq/sdcard_files.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "I'm trying to find my files on the host or SD card. Where are they?"
ha_category: Home Assistant
---

On a Home Assistant OS install, your files are on the data partition within `/mnt/data/supervisor/`.
On a {% term "Home Assistant Operating System" %} installation, your files are on the data partition within `/mnt/data/supervisor/`.
On the SD itself, this is an EXT4 partition labeled `hassos-data`.

On a Supervised install, they are in `/usr/share/hassio/`.
For information on file access, refer to the section on [configuring access to files](/common-tasks/os/#configuring-access-to-files).
1 change: 0 additions & 1 deletion source/_includes/asides/docs_sitemap.html
Original file line number Diff line number Diff line change
Expand Up @@ -246,7 +246,6 @@
<ul>
<li>{% active_link /docs/tools/dev-tools/ Developer tools %}</li>
<li>{% active_link /docs/tools/quick-bar/ Quick bar %}</li>
<li>{% active_link /docs/tools/hass/ hass %}</li>
<li>{% active_link /docs/tools/check_config/ check_config %}</li>
</ul>
{% endif %}
Expand Down
2 changes: 1 addition & 1 deletion source/_includes/common-tasks/lost_password.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
## Lost Password and password reset

Please refer to the [I'm locked out!](/docs/locked_out/#home-assistant-including-supervised) documentation page.
Please refer to the [I'm locked out!](/docs/locked_out/) documentation page.
27 changes: 23 additions & 4 deletions source/_integrations/calendar.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,22 @@ The **Calendar** {% term integration %} provides calendar {% term entities %}, a
to integrate calendars into Home Assistant. Calendars are shown on the calendar
dashboard and can be used with automations.

This page does not provide instructions on how to create calendar
entities. Please see the ["Calendar" category](/integrations/#calendar) on the
integrations page to find integrations offering calendar entities. For example, [Local Calendar](/integrations/local_calendar/) is a fully local integration to create calendars and events within your Home Assistant instance or other integrations work with other services providing calendar data.

{% include integrations/building_block_integration.md %}

## Getting started with calendars

Home Assistant’s calendar support is designed primarily for automation use cases. It allows you to trigger automations based on events and access event information provided by calendar integrations, regardless of where the actual calendar data is stored. When supported by a given integration, Home Assistant can also create, edit, and delete events in external calendars, making it possible to interact with calendars both for reading and writing.

Home Assistant is not intended to replace a full-featured personal calendar. Instead, it works alongside external calendar platforms and complements them with powerful automation capabilities.

Depending on your needs, you can choose from several approaches:

- Use an existing external calendar: Explore the built-in [calendar integrations](/integrations/#calendar) to connect Home Assistant to your preferred calendar platform and use its events for automations.

- Run your own full-featured, privacy-focused calendar platform: Solutions like [Nextcloud Calendar](https://apps.nextcloud.com/apps/calendar) or other [self-hosted calendar platforms](https://github.com/awesome-selfhosted/awesome-selfhosted) provide complete calendar functionality and expose calendars over CalDAV. You can integrate them with Home Assistant using the [CalDAV integration](/integrations/caldav/) while keeping full calendar management outside Home Assistant.

- Use a simple, local event store for automations: The [Local Calendar integration](/integrations/local_calendar/) provides a fully local calendar designed specifically for automation workflows. It is not intended to function as a general-purpose personal calendar.

## Viewing and managing calendars

Each calendar is represented as its own {% term entity %} in Home Assistant and can be
Expand All @@ -31,8 +41,17 @@ Some calendar integrations allow Home Assistant to manage your calendars
directly from Home Assistant. In this case, you can add new events by selecting
the **Add event** button in the lower right corner of the calendar dashboard.

The calendar dashboard provides quick visibility into upcoming events and simple
event editing, making it easier to build and troubleshoot automations that depend
on calendar data.

Also see [Actions](#actions) below.

## Calendar card

To display calendar events directly on your dashboards, Home Assistant includes the [calendar card](/dashboards/calendar/).
The card shows upcoming events from one or more calendar entities and provides a quick,glanceable view of your schedule.
Copy link

Copilot AI Nov 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing space after comma in "quick,glanceable view". Should be "quick, glanceable view".

Suggested change
The card shows upcoming events from one or more calendar entities and provides a quick,glanceable view of your schedule.
The card shows upcoming events from one or more calendar entities and provides a quick, glanceable view of your schedule.

Copilot uses AI. Check for mistakes.

## The state of a calendar entity

The state shows whether or not there is an active event:
Expand Down
4 changes: 4 additions & 0 deletions source/_integrations/command_line.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -329,8 +329,12 @@ To use your Command binary sensor in your installation, add the following to you
command_line:
- binary_sensor:
command: "cat /proc/sys/net/ipv4/ip_forward"
payload_on: "1"
payload_off: "0"
- binary_sensor:
command: "echo 1"
payload_on: "1"
payload_off: "0"
```
{% endraw%}

Expand Down
Loading