diff --git a/docs/assets/esphome-device-builder-linux-install.gif b/docs/assets/esphome-device-builder-linux-install.gif new file mode 100644 index 0000000000..a298651c8a Binary files /dev/null and b/docs/assets/esphome-device-builder-linux-install.gif differ diff --git a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md index 7649d9c1a1..4e097349c7 100755 --- a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md +++ b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md @@ -92,20 +92,35 @@ Pick the platform you'll be running ESPHome Device Builder on: === "Linux" - 1. Open desktop.esphome.io. Under the **Linux** tab, pick the package for your distro: + 1. Open desktop.esphome.io. The page opens on the **Linux** tab and shows **Download .deb** as the default. Click **Download .deb** to grab the Debian / Ubuntu package. - - **AppImage** (works on any distro) - - **.deb** (Debian / Ubuntu) - - **.rpm** (Fedora / RHEL) - - **AUR** (Arch Linux) + If your distro fits a different format, switch to the matching tab on the download page first: - 2. Install or run the file you downloaded: + - **Fedora / RHEL** → downloads a `.rpm` + - **Arch (AUR)** → opens the AUR package page + - **AppImage** → downloads a portable AppImage that runs on any distro - - **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` + 2. Install the package. Pick the workflow you're more comfortable with: - + === "GUI" + + Works for the `.deb` download. Skip to the CLI tab if you grabbed a `.rpm`, AUR package, or AppImage. + + 1. Open your **Downloads** folder in your file manager. + 2. Right-click the `ESPHome.Builder_*.deb` file and choose **Open with → Archive Manager** (or whichever archive viewer your distro ships). + 3. In the archive viewer, click **Extract** and pick a folder you can find again, like `~/esphome-desktop`. + 4. Open the extracted folder, then navigate into **`usr`** → **`bin`**. + 5. Double-click **`esphome-desktop`** to launch the app. + + ![](../../../assets/esphome-device-builder-linux-install.gif) + + === "CLI" + + From a terminal, run the installer that matches the file you downloaded: + + - **.deb (Debian / Ubuntu):** `sudo apt install ./ESPHome.Builder_*.deb` + - **.rpm (Fedora / RHEL):** `sudo dnf install ./ESPHome.Builder*.rpm` + - **AppImage (any distro):** `chmod +x ESPHome.Builder_*.AppImage` then double-click the file, or run it from a terminal. Once installed, a web browser should launch and navigate to http://localhost:6052/. Once you see this page, your ESPHome Device Builder installation is complete.