Arch Linux is one of the two recommended Polaris package paths, and the official
Polaris-arch-x86_64.pkg.tar.zst asset ships with every release. CachyOS and most pacman-compatible
Arch derivatives should start with this same package.
SteamOS is pacman-based but is not covered by this page: it has its own versioned package and a
read-only root, so follow the SteamOS guide instead. The two packages are not
interchangeable.
The package installs the host binary, the web console assets, desktop metadata, and the user service
file. Host integration stays explicit: --setup-host is a separate step you run yourself.
Upgrade or reinstall: open https://localhost:47990/#/login and use the existing account.
Arch and CachyOS package operations preserve credentials, pairing keys, settings, and the library
under ~/.config/polaris; removing the package does not reset the web account. If needed, follow
the credential reset instead of returning to Welcome.
It installs the udev rules and modules-load configuration that make virtual input work, and reports
anything it could not complete.
[!WARNING]
Only turn on DRM/KMS capture when you actually need it. Polaris works without it on the default
compositor and Headless Stream paths. It takes two steps, and the first one is a package:
Terminal window
sudopacman-Spolaris-kms
sudo-Hpolaris--setup-host--enable-kms
The capability lives in that package’s own metadata rather than on the Polaris binary, so an
update no longer takes it away. --enable-kms only points the user service at the packaged
helper, and refuses if the package is not installed. --disable-kms points it back.
An upgrade has to move both packages together, because polaris-kms depends on the exact version
of polaris beside it: sudo pacman -Syu polaris polaris-kms.
If you ran --setup-host on a version before v1.3.5, a copy of the udev rules may still sit in
/etc/udev/rules.d/60-polaris.rules and override the packaged file. Host setup keeps it and warns
rather than deleting it; see Troubleshooting for the check and removal.
The application menu entry starts this same user service, so a desktop launch and autostart never
run two copies. Quitting from the tray stops it; the menu entry or systemctl --user start polaris
brings it back.
CachyOS is expected to work through this package path. CachyOS handheld edition boots into a Steam
Game Mode session; read Handhelds and Game Mode before the first mode switch, or
Polaris goes offline with the desktop. If a derivative renames dependencies or ships
different runtime helpers, the package may refuse to install or Polaris may fail to find a helper at
launch. In that case use the local package or source build in
Build from source, and please report the derivative-specific gap with your distro, GPU,
driver, compositor, and package details.
What you’ll see: with this configuration the built-in Desktop entry streams Polaris’
private compositor — an intentionally empty screen (right-click opens the session menu) until a
game is launched from your client. If you wanted a desktop stream instead, pick the mode for it:
I want
Set linux_stream_mode to
My real desktop, at host resolution
desktop_display (Mirror Desktop)
An extra display, sized to the client
host_virtual_display
An isolated game-only session, desktop untouched
headless_stream (this recommended setup)
Moonlight-protocol clients can also request the mirror per launch with mirrorDesktop=1 on
/launch. And mind the trap: headless_mode = enabledwithoutlinux_use_cage_compositor
selects host_virtual_display, not a headless session.
Then start a game and read the active runtime, capture path, and encoder in Mission Control. See
Runtime and streaming model for what those values mean.
Your configuration, pairing keys, and library stay in ~/.config/polaris across upgrades.
Sign back in at https://localhost:47990/#/login with the existing web credentials.
Arch and SteamOS builds produce a separate polaris-debug package with detached
symbols. Release assembly checks that its version, architecture and ELF build ID
match the host and KMS helper before including it in the release.
Download Polaris-debug-arch-x86_64.pkg.tar.zst or
Polaris-debug-steamos3.8-x86_64.pkg.tar.zst from the same release as the installed
host, then install that file with sudo pacman -U. Older releases may not include
a debug asset; matching symbols then need to be built from that release’s source.
Use coredumpctl list to find the Polaris crash, then coredumpctl debug PID with
that crash’s PID to open the debugger with the installed symbols. coredumpctl info
shows the recorded report; installing symbols does not rewrite that earlier report.