From 9e2edf82959d4663a4338a92bd2d23a6b0b9c36b Mon Sep 17 00:00:00 2001 From: Brandon Harvey <8107750+bharvey88@users.noreply.github.com> Date: Wed, 20 May 2026 09:35:16 -0500 Subject: [PATCH] docs: point ESPHome Device Builder install to desktop.esphome.io (#840) The previous tabs hardcoded v0.7.0 GitHub release URLs and Linux example filenames, all of which rot on every ESPHome release. Replace the version-pinned download links in the Windows, Mac, and Linux tabs with prose pointing readers to desktop.esphome.io (which always serves the latest installer for each OS and adds AUR for Arch users). Genericise the Linux install commands with wildcard filenames so the copy-pasteable examples no longer reference 0.7.0. The Home Assistant App tab is unchanged (desktop.esphome.io does not cover the HA install path) and the Backend Beta toggle steps stay in place until the new backend ships as the desktop default. Co-authored-by: Brandon Harvey --- .../ESPHome-Starter-Kit/setup/first-steps.md | 23 ++++++++++--------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md index 968d72b7fe..6ab84b2c4d 100755 --- a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md +++ b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md @@ -22,7 +22,7 @@ Pick the platform you'll be running ESPHome Device Builder on: === "Windows" - 1. Download the ESPHome Device Builder for Windows. + 1. Open desktop.esphome.io and click **Download installer** under the **Windows** tab. 2. Open the installer and click **Next** then click **Next** again to start the installation process. Once it shows completed, click **Next** again then **Finish** to complete the installation. * If Windows shows a blue **Windows protected your PC** warning, click **More info → Run anyway** to continue. @@ -40,10 +40,10 @@ Pick the platform you'll be running ESPHome Device Builder on: === "Mac" - 1. Download the ESPHome Device Builder for Mac. Pick the build that matches your chip: + 1. Open desktop.esphome.io. The page detects your OS and shows the macOS downloads. Pick the build that matches your chip: - - Apple Silicon (M1, M2, M3, M4) - - Intel Mac + - **Apple Silicon** (M1, M2, M3, M4) + - **Intel Mac** 2. Open the `.dmg` and drag **ESPHome Builder** into your Applications folder. Launch it from Applications or Spotlight. @@ -83,17 +83,18 @@ Pick the platform you'll be running ESPHome Device Builder on: === "Linux" - 1. Download the ESPHome Device Builder for Linux. Pick the package that fits your distro: + 1. Open desktop.esphome.io. Under the **Linux** tab, pick the package for your distro: - - AppImage (works on any distro) - - .deb (Debian / Ubuntu) - - .rpm (Fedora / RHEL) + - **AppImage** (works on any distro) + - **.deb** (Debian / Ubuntu) + - **.rpm** (Fedora / RHEL) + - **AUR** (Arch Linux) 2. Install or run the file you downloaded: - - **AppImage:** `chmod +x ESPHome.Builder_0.7.0_amd64.AppImage` then double-click the file, or run it from a terminal. - - **.deb:** `sudo apt install ./ESPHome.Builder_0.7.0_amd64.deb` - - **.rpm:** `sudo dnf install ./ESPHome.Builder-0.7.0-1.x86_64.rpm` + - **AppImage:** `chmod +x ESPHome.Builder_*.AppImage` then double-click the file, or run it from a terminal. + - **.deb:** `sudo apt install ./ESPHome.Builder_*.deb` + - **.rpm:** `sudo dnf install ./ESPHome.Builder*.rpm`