Squish GUI Testing with Docker - Sway for Wayland AUTs

Fri, 13 Nov 2026 00:00:00 +0100

Overview¶

This is a follow-up to Squish GUI Testing with Docker: XVFB for X11 Auts (the X11 article), which covered a Docker + Xvfb setup for Squish. Most of that carries over unchanged. This article only covers what's different when the AUT is a Wayland-native application instead of an X11 one.

Figure 1: Ports are published with -p 5555:4322 (squishserver) and -p 5901:5900 (VNC). Tests can run inside the container with docker exec, where squishrunner reaches squishserver on localhost:4322, or from a host client through published port 5555. The test suite is either bind-mounted from the host examples folder at /app/examples or taken from the examples bundled with the Squish installation in /app/squish/examples.

Wayland on Software Quality Solutions Knowledge Base

Squish GUI Testing with Docker - Sway for Wayland AUTs

Overview¶