Skip to content

chore: sync dev with main #927

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bharvey88 merged 1 commit into from
Jun 3, 2026
Merged

chore: sync dev with main #927

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
Binary file added docs/assets/esphome-device-builder-linux-install.gif
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
35 changes: 25 additions & 10 deletions docs/products/ESPHome-Starter-Kit/setup/first-steps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,20 +92,35 @@ Pick the platform you'll be running ESPHome Device Builder on:

=== "Linux"

1. Open <a href="https://desktop.esphome.io" target="_blank" rel="noreferrer nofollow noopener">desktop.esphome.io</a>. Under the **Linux** tab, pick the package for your distro:
1. Open <a href="https://desktop.esphome.io" target="_blank" rel="noreferrer nofollow noopener">desktop.esphome.io</a>. 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:

<!-- TODO: add a Linux installer screenshot if available. -->
=== "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 <a href="http://localhost:6052/" target="_blank" rel="noreferrer nofollow noopener">http://localhost:6052/</a>. Once you see this page, your ESPHome Device Builder installation is complete.

Expand Down