From a981f1300dbb4b0d56c7f0677826a1a21c3cf09e Mon Sep 17 00:00:00 2001
From: Gord <31004434+googanhiem@users.noreply.github.com>
Date: Thu, 22 May 2025 17:48:17 +0100
Subject: [PATCH] Deprecation blog upload (#39149)
---
...lation-methods-and-32-bit-systems.markdown | 121 ++++++++++++++++++
.../blog/2025-05-deprecation/analytics.png | Bin 0 -> 77470 bytes
.../images/blog/2025-05-deprecation/art.png | Bin 0 -> 115776 bytes
.../blog/2025-05-deprecation/methods.png | Bin 0 -> 31716 bytes
.../system-information.png | Bin 0 -> 77716 bytes
5 files changed, 121 insertions(+)
create mode 100644 source/_posts/2025-05-22-deprecating-core-and-supervised-installation-methods-and-32-bit-systems.markdown
create mode 100644 source/images/blog/2025-05-deprecation/analytics.png
create mode 100644 source/images/blog/2025-05-deprecation/art.png
create mode 100644 source/images/blog/2025-05-deprecation/methods.png
create mode 100644 source/images/blog/2025-05-deprecation/system-information.png
diff --git a/source/_posts/2025-05-22-deprecating-core-and-supervised-installation-methods-and-32-bit-systems.markdown b/source/_posts/2025-05-22-deprecating-core-and-supervised-installation-methods-and-32-bit-systems.markdown
new file mode 100644
index 00000000000..fb8524ddcb3
--- /dev/null
+++ b/source/_posts/2025-05-22-deprecating-core-and-supervised-installation-methods-and-32-bit-systems.markdown
@@ -0,0 +1,121 @@
+---
+layout: post
+title: "Deprecating Core and Supervised installation methods, and 32-bit systems"
+description: "This deprecation will help focus support efforts and streamline development."
+date: 2025-05-22 00:00:00
+date_formatted: "May 22, 2025"
+author: Franck Nijhof
+author_twitter: frenck
+comments: true
+categories: Public-Service-Announcement
+og_image: /images/blog/2025-05-deprecation/art.png
+---
+
+
+
+We are today officially deprecating two installation methods and three legacy CPU architectures. We always strive to have Home Assistant run on almost anything, but sometimes we must make difficult decisions to keep the project moving forward. Though these changes will only affect a small percentage of Home Assistant users, we want to do everything in our power to make this easy for those who may need to migrate.
+
+Beginning with Home Assistant 2025.6, affected systems will display a notification after updating, indicating that **support will end in six months (with release 2025.12)** and include a recommendation to [migrate to a supported system](#how-to-migrate). In this post, we'll go into our thinking on these deprecations and our findings after consulting the community on these changes.
+
+We have deprecated the following installation methods:
+
+- **Home Assistant Core** installation method, where you run your system in a Python environment, not to be confused with Container (for example, running your system in Docker).
+- **Home Assistant's Supervised** installation method, which involves running your own operating system, then installing the Supervisor and other requirements on top of that.
+
+These are advanced installation methods, with only a small percentage of the community opting to use them. If you are using these methods, you can continue to do so (you can even continue to update your system), but in six months time, you will no longer be supported, which I'll explain the impacts of in the next section. References to these installation methods will be removed from our documentation after our next release (2025.6). Going forward [Home Assistant OS](https://github.com/home-assistant/operating-system) and [Home Assistant Container](https://hub.docker.com/r/homeassistant/home-assistant) will become the only supported installation methods.
+
+In the future, only the currently supported 64-bit architectures (aarch64 and amd64) will be used. The following legacy architectures are being deprecated:
+
+- **i386** (32-bit x86) is an architecture used by Intel and AMD predominantly before 2003, but some later processors still utilized it (e.g., early Intel Atom models).
+- **armhf** (32-bit ARM hard-float) was used by very early single-board computers, notably the original Raspberry Pi.
+- **armv7** (32-bit ARM) was used by a number of early single-board computers, most notably the Raspberry Pi 2.
+
+If you are one of the few with a system using these architectures, you will receive a notification after updating to 2025.6, and it will describe how to migrate your system. In six months, your system will become unsupported and will no longer receive updates.
+
+[Check our guide to see if your current Home Assistant installation is affected.](#check-if-youre-affected)
+
+## What does deprecated and unsupported mean
+
+In the simplest terms, deprecation is where you stop recommending a certain feature to users as you intend to remove it soon. As we deprecated the Core and Supervised installations methods today, that means we are now working to remove all references to them from our documentation. The goal is to guide new users towards installation methods we plan to support long term, and discourage the use of those that are being phased out.
+
+Even though they are being deprecated, we are committing to support them for a further six months (until release 2025.12), giving existing users time to migrate to Home Assistant OS or Container. During this time we will ensure these installation types keep functioning as normal during the deprecation period. However, after those six months have elapsed, these methods will become unsupported, which means issue reports will no longer be accepted. As these installation methods are used for the development of Home Assistant, it will still be technically possible to update them. We still would recommend migrating to a supported method, but that's your choice.
+
+As i386, armhf, and armv7 architectures have also been deprecated, we are currently removing references to them from our documentation. More importantly, they will also be subject to a six-month support window. After that support ends (from release 2025.12 onwards), we will no longer build or release distributions or containers targeting these platforms. This will mean that in six months' time, there will be no more updates for these systems, and if users encounter issues, they will no longer be able to ask for support from Home Assistant maintainers.
+
+## Why we made this decision
+
+### Core and Supervised
+
+
From our opt-in analytics
+
+The Core and Supervised installation methods are not only complex for users to install and maintain --- they're also challenging for the Home Assistant team to support. In the past, there were compelling reasons, outside Home Assistant development, to run these installation methods, but for most people those reasons are disappearing. Home Assistant OS is very capable with a rich ecosystem of add-ons, while also being easy to run in a virtual machine. Container adoption has become mainstream, now being widely available along with systems having more resources to run them. Steadily, we've seen year-on-year reductions in the percentage of Core and Supervised installations (currently standing at 2.5% and 3.3% respectively).
+
+As Core and Supervised are more complex to maintain, they generate more issues that are more difficult to solve. This complexity places a disproportionate burden on our community-driven support system, where volunteers generously give their time to help others. It also takes time away from assisting the vast majority of users who are on the simpler to maintain installation methods. Along with this, new users could sometimes be swayed into running Core or Supervised, and have a bad experience that could cause them to give up on the best way to automate their home. By focusing our support and documentation on OS and Container methods, we can greatly improve the onboarding experience and ensure a smoother start for new users.
+
+### Legacy 32-bit architectures
+
+Though Home Assistant is very lean and can run great on older or low-spec hardware, the architectures we're deprecating are definitely on the leaner side of the spectrum. That probably explains why we see such low usage figures, with i386 and armhf architectures representing less than 0.5% of installations each, and armv7 at only 0.95% of installations. More than half of Home Assistant systems using armv7 have hardware that is capable of running 64-bit operating systems, like Raspberry Pi 3 and 4. This hardware can actually upgrade and migrate to a supported 64-bit version of our Home Assistant Operating System
+
+The broader software and hardware industries have also shifted away from these older 32-bit systems. Most have adopted 64-bit architectures such as amd64 and aarch64, and we are seeing more projects we depend on no longer supporting these 32-bit architectures. There have already been several instances where keeping support for these architectures has held back the development of new features.
+
+## Your feedback
+
+For any major change, it is our goal to make sure the community guides this decision-making. When our maintainers initially proposed these deprecations, we shared this plan with the community (in our forum, GitHub, Discord, Reddit, and other social channels), using it to gather feedback. It was a constructive, civil discussion, and we learned a couple of interesting things that have helped us move this decision forward.
+
+First, our current wording is confusing to the community. Core and Supervisor are components of Home Assistant OS, but are also similar---or the same---as the names of installation methods, which is not super clear for new users. We also found these installation methods being used in ways we never expected, and there are a good number of people who were already running Home Assistant in custom and unsupported ways, not even realizing they were unsupported.
+
+Many of those impacted asked for better guidance on how to migrate. A good number were unaware of our expansion of backup and restore features to all installation methods, significantly smoothing their transition to a new platform.
+
+## Check if you're affected
+
+
The blue arrow shows your installation type, and the red arrow displays the architecture.
+
+If you are unsure which **installation method** you are running:
+
+- Select [this link](https://my.home-assistant.io/redirect/system_health/) OR Navigate to ***Settings > System > Repairs***, select the three-dotted menu in the top right corner, and select ***System information***.
+- Check the Installation type field. If you are running Home Assistant OS, or Container, you are fine as the installation method deprecation doesn't apply to you.
+
+In this [same window](https://my.home-assistant.io/redirect/system_health/), you can find the **architecture** as well:
+
+- The CPU architecture field will tell you exactly which architecture you are using. If you are seeing aarch64 or x86_64 here, you are fine as the architecture deprecation doesn't apply to you.
+
+## How to migrate
+
+
Green are staying, and red are deprecated.
+
+If it's been a while since you've migrated Home Assistant systems, a lot has improved over the past several years. Switching systems is as easy as [making a backup](/common-tasks/general/#backups), downloading it, and [restoring](/common-tasks/general/#restoring-a-backup) it during the initialization of your new system (Home Assistant Cloud subscribers using off-site backups can restore [with just their password](/blog/2025/04/02/release-20254/#onboarding-with-a-home-assistant-cloud-backup)). Every Home Assistant installation method now has backups, and you can restore backups from any method onto another regardless of the differences in architecture. In many cases, very little needs to be done once the restore is successful ([to the dismay of tinkerers online](https://www.reddit.com/r/homeassistant/comments/1kdip17/are_you_kidding_me/)). Our documentation has a full list of guides on [how to install Home Assistant on different hardware](/installation/).
+
+Before you think about migrating to a different installation method, you can always choose to stick with what you have. Just because it becomes unsupported by the Home Assistant project, it doesn't mean you can't keep running it like you do today. That choice is up to you.
+
+| Need | Currently using | Migrate to |
+| ------------------------------------------ | --------------- | -------------------------------------------------------------------------- |
+| Home Assistant with add-ons | Supervised | Home Assistant OS |
+| A system without Home Assistant OS support | Supervised | Container (many add-ons can be run as containers alongside Home Assistant) |
+| Full control of the host system | Supervised | Run Home Assistant OS in a VM, or Container (alongside add-on containers) |
+| Lightweight solution | Core | Container |
+
+For **Home Assistant Core** users, the closest alternative is Home Assistant Container, which is most commonly used with Docker. If you can dedicate a device exclusively to Home Assistant, the recommended installation method is Home Assistant OS, which gives an appliance-like setup.
+
+For **Home Assistant Supervised** users, we recommend migrating to Home Assistant OS---it supports everything Supervised does, including add-ons. If you want more control over the OS, you can also run Home Assistant OS in a virtual machine, like with Proxmox, or go the Home Assistant Container path alternatively.
+
+For **deprecated architectures**, there is generally no supported migration path using your existing hardware. You will therefore need to find alternative hardware compatible with Home Assistant OS or Container. Second-hand single-board computers and recycled small-form-factor office machines are affordable and sustainable options. In some cases, your system may be running a 32-bit operating system, but is capable of running a 64-bit one (Raspberry Pi 3 and 4 are examples of systems often running a 32-bit OS despite being capable of running 64-bit). In this case, you will need to install a 64-bit capable operating system and restore Home Assistant on that system.
+
+## Frequently asked questions
+
+- ***If Home Assistant Core is used for development, and part of the developer docs, why not just offer it to end-users?***\
+ This is not just about technical viability, it is also about helping and supporting people with their issues, problems, and questions, in our forums and chat. Having these options available to less technical people leads to support queries, and if they have a bad first experience that reflects poorly on the project. Users are free to continue running their systems the way they would like.
+
+- ***No support for Core or Supervised---can I still use them?***\
+ You can still use them even if we no longer support them. There are many users running Home Assistant in all kinds of unofficial ways. This change just means we are removing it from our end-user documentation and will no longer recommend using these installation methods from an official standpoint.
+
+- ***Will the developer documentation on these things remain?***\
+ Yes, those will remain. The developer documentation for running Home Assistant's Core Python application directly in a Python virtual environment will remain. This is how we develop. This proposal is about removing end-user documentation and support.
+
+- ***Can I start maintaining these installation methods?***\
+ While maintaining these methods will require effort, the community is free to move documentation and code to new independent projects. Our maintainers will no longer accept issues or provide end-user documentation, but that shouldn't stop anyone passionate about them from continuing to run them, or helping others to do the same.
+
+- ***Can I reproduce any of the installations you offer?***\
+ Yes, of course! All our pipelines are open source and transparent, you can always recreate any of our pipelines and release artifacts; either automated or manual.
+
+- ***Is this the first step towards making Home Assistant closed source/proprietary/commercial?***\
+ No, that is impossible. Home Assistant will always remain open source. Home Assistant is owned by the [Open Home Foundation](https://www.openhomefoundation.org/), a Swiss non-profit foundation that is audited and governed, and---by law---bound by its mission. This means it will always be open source and cannot be bought or sold.
diff --git a/source/images/blog/2025-05-deprecation/analytics.png b/source/images/blog/2025-05-deprecation/analytics.png
new file mode 100644
index 0000000000000000000000000000000000000000..b7f5522ccab68af7130cec7c217a30e861d21e43
GIT binary patch
literal 77470
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
z
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