installing ghostty on a steam deck and steam machine (steamos)

You can install Ghostty on a Steam Deck or Steam Machine running SteamOS using Distrobox with an Arch Linux container. Ghostty is not on Flathub, SteamOS’s read-only filesystem blocks pacman and the AUR, and the Ghostty Flatpak CI is currently broken (as of August 2026). Distrobox is the working method.

Run these four commands:

distrobox create --name arch --image archlinux:latest
distrobox enter arch
sudo pacman -S ghostty
distrobox-export --app ghostty

That’s it. Ghostty shows up in your app launcher.

why this works

Distrobox creates an Arch Linux container that shares your home directory with the host. You get a full Arch package manager without touching SteamOS’s read-only filesystem. The container persists across reboots.

why not flatpak?

Ghostty has a Flatpak manifest and a CI workflow that builds .flatpak bundles, but the workflow has been failing on every run since at least late July 2026. Both x86_64 and aarch64 jobs fail with an xvfb-run error. No artifacts are produced, so there’s nothing to download. If you searched for “ghostty flatpak” and ended up here, this is why.

gotchas

• Missing tools. The Arch container is minimal. which, git, curl etc. aren’t installed. pacman -S what you need, or use command -v instead of which.
• Filesystem. Your home dir is fully read-write from inside the container. Files you create are visible on the host immediately.
• Shell integration works. Most features behave like a native install. “New terminal in current directory” may not work depending on your session type.
• Desktop Mode only. Ghostty needs GPU acceleration and a proper compositor. It may not render correctly in Gaming Mode (Gamescope).
• Updating. distrobox enter arch && sudo pacman -Syu. SteamOS updates won’t touch the container.

If the Flatpak CI gets fixed or Ghostty lands on Flathub, this guide may be outdated (check the Ghostty GitHub for the latest status).

← all posts