Add Supervisor unsupported system architecture info #41618
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
The Supervisor gains a new unsupported flag "system_architecture" which marks systems running on the deprecated architectures (`i386`, `armhf` and `armv7`) as unsupported. Add documentation about this new flag to the unsupported system architecture page.
home-assistant
bot
added
current
|
It seems that this PR is targeted against an incorrect branch since it has a parent PR on one of our codebases. Documentation that needs to be updated for an upcoming release should target the |
✅ Deploy Preview for home-assistant-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR adds a new documentation page explaining why certain 32-bit system architectures (i386, armhf, and armv7) are marked as unsupported by Home Assistant Supervisor, and provides guidance on migrating to supported 64-bit hardware.
Key changes:
- Documents the sunset of 32-bit architectures announced in May 2025
- Explains the impact on updates for unsupported architectures
- Provides migration steps using backup and restore
c0ffeeca7
requested changes
Nov 6, 2025
Comment on lines
+8
to
+9
| Supervisor considers `i386`, `armhf` and `armv7` (all 32-bit system architectures) | ||
| as unsupported. Home Assistant announced sunset of these architectures in May 2025 |
Contributor
There was a problem hiding this comment.
Suggested change
| Supervisor considers `i386`, `armhf` and `armv7` (all 32-bit system architectures) | |
| as unsupported. Home Assistant announced sunset of these architectures in May 2025 | |
| Supervisor considers `i386`, `armhf`, and `armv7` (all 32-bit system architectures) | |
| as unsupported. Home Assistant announced the sunset of these architectures in May 2025 |
Comment on lines
+11
to
+13
| On these system architectures Supervisor stops refreshing its update | ||
| information. This means you will no longer receive updates for any component, | ||
| including Home Assistant Core or Add-on updates. |
Contributor
There was a problem hiding this comment.
Suggested change
| On these system architectures Supervisor stops refreshing its update | |
| information. This means you will no longer receive updates for any component, | |
| including Home Assistant Core or Add-on updates. | |
| On these system architectures, the Supervisor stops refreshing its update | |
| information. This means you will no longer receive updates for any component, | |
| including Home Assistant Core or Add-on updates. |
Comment on lines
+17
to
+19
| You'll be able to continue to use the system as is, but we recommend to move your | ||
| Home Assistant installation onto supported hardware. This makes sure that you'll | ||
| continue to receive software updates, including security updates. |
Contributor
There was a problem hiding this comment.
Suggested change
| You'll be able to continue to use the system as is, but we recommend to move your | |
| Home Assistant installation onto supported hardware. This makes sure that you'll | |
| continue to receive software updates, including security updates. | |
| You can continue to use the system as is, but it is recommended to move your | |
| Home Assistant installation onto supported hardware. This makes sure that you'll | |
| continue to receive software updates, including security updates. |
Comment on lines
+21
to
+25
| To migrate to a supported architecture, [create a full backup](/common-tasks/general/#backups) | ||
| and download it. Install Home Assistant OS on supported 64-bit hardware. Use the | ||
| [restore from backup feature during on-boarding](https://www.home-assistant.io/getting-started/onboarding/) (Option 2). | ||
| If you use a Raspberry Pi 3 or Raspberry Pi 4, you can install the 64-bit variants | ||
| of Home Assistant OS. See the [Raspberry Pi installation documentation](https://www.home-assistant.io/installation/raspberrypi/) for detailed instructions. |
Contributor
There was a problem hiding this comment.
Suggested change
| To migrate to a supported architecture, [create a full backup](/common-tasks/general/#backups) | |
| and download it. Install Home Assistant OS on supported 64-bit hardware. Use the | |
| [restore from backup feature during on-boarding](https://www.home-assistant.io/getting-started/onboarding/) (Option 2). | |
| If you use a Raspberry Pi 3 or Raspberry Pi 4, you can install the 64-bit variants | |
| of Home Assistant OS. See the [Raspberry Pi installation documentation](https://www.home-assistant.io/installation/raspberrypi/) for detailed instructions. | |
| 1. To migrate to a supported architecture, [create a full backup](/common-tasks/general/#backups) | |
| and download it. | |
| 2. Install Home Assistant OS on supported 64-bit hardware. | |
| - Use the [restore from backup feature during onboarding](https://www.home-assistant.io/getting-started/onboarding/) (Option 2). | |
| - If you use a Raspberry Pi 3 or Raspberry Pi 4, you can install the 64-bit variants | |
| of Home Assistant OS. | |
| - See the [Raspberry Pi installation documentation](https://www.home-assistant.io/installation/raspberrypi/) for detailed instructions. |
I think numbered steps would be helpful here.
|
Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Proposed change
The Supervisor gains a new unsupported flag "system_architecture" which marks systems running on the deprecated architectures (
i386,armhfandarmv7) as unsupported. Add documentation about this new flag to the unsupported system architecture page.Type of change
currentbranch).currentbranch).nextbranch).nextbranch).Additional information
Checklist
currentbranch.nextbranch.