Skip to content

Requirements

Component Requirement
OS Linux.
Container engine Docker Engine 20.10+ or Podman 5.1+. See Container engines for current support status.
Disk Allow about 20 GB for container images, then additional space for installed games, saves and user files. Check where your engine stores images as well as your homes disk.
CPU and RAM Quasar’s services have modest overhead. Size the host for the games and number of simultaneous sessions you intend to run; the GPU handles video encoding. The 8 vCPU / 32 GB test host is a test configuration, not a minimum.

Docker Desktop on macOS or Windows, and WSL, are unsupported.

Quasar runs on Docker and Podman in rootful or rootless mode. Rootless modes and rootful Podman remain experimental.

Podman 5.1 or later. Older Podman can’t change a container’s restart policy, which installing and updating Quasar need, so the quick start and Add host refuse it. Ubuntu 24.04 ships Podman 4.9: use Docker there, or a newer Podman.

EngineRootfulRootless
DockerSupportedExperimental
PodmanExperimentalExperimental

Supported: tested end to end. Experimental: tested, with release validation still incomplete. Tests cover rootful Docker with AMD/NVIDIA, and Podman/rootless on Fedora uCore and Workstation; this does not validate every distribution.

What’s the difference between rootful and rootless?

Section titled “What’s the difference between rootful and rootless?”

The documented Podman and rootless installation paths require systemd; Quasar on rootful Docker does not. Run one Quasar installation per engine. Compose, Dockge and Arcane can manage its seed; Portainer and Kubernetes are unsupported.

Vendor Encoder Current validation
NVIDIA Vulkan Video Verified
AMD Vulkan Video Verified
Intel VA-API Untested
No GPU Software H.264 Too slow for practical play

Your browser must reach each GPU host directly over your LAN or VPN. A reverse proxy can carry the web app and API; it cannot carry the game stream.

For a default install, allow these connections from the relevant LAN or VPN peers:

PortProtocolPurposeDirection
8443TCP / HTTPSWeb app and APIBrowser → control plane
8080TCP / HTTPEnrollment and healthGPU host → control plane; local health checks
9091TCP / HTTPAgent healthLocalhost on GPU host only
Host ephemeral rangeUDPGame stream and inputBrowser ↔ GPU host, directly
5353UDP / mDNSChromium local ICE candidatesLAN peers ↔ GPU host

The UDP range is chosen by Linux: check cat /proc/sys/net/ipv4/ip_local_port_range on the GPU host. A default-deny firewall must allow it even when login works. See Firewall rules and custom ports and Remote access. Optional UDP buffer tuning is in Latency.

Use recent Chrome or Chromium. Firefox works with some limits and Safari is untested; see Browser support.

HTTPS is required for gamepads, keyboard lock and the microphone. The install steps configure Quasar’s certificate; see HTTPS and certificates for trusting it or using a reverse proxy.