Linux
QwenWork for Debian-based Linux
One package format, two architectures, and a hard rule: it will not run as root. Everything else is a dependency conversation.
Check the architecture first
uname -m
x86_64 → linux-amd64.deb
aarch64 → linux-arm64.debThe two packages are not interchangeable and there is no multi-arch build. Installing the wrong one fails at dpkg with an architecture mismatch, which is at least a clear error.
Install with apt, not dpkg -i
sudo apt install ./qwenworkcn-linux-amd64.debPassing the local file to apt resolves the dependency tree in one transaction — GTK, WebKit, and the usual library set. dpkg -i installs the package and leaves you with a list of unmet dependencies to fix by hand, which is only worth doing when you are deliberately holding libraries back for compatibility.
It will not run as root
Starting the client from a root shell exits immediately, with no useful message. This is intentional: the app writes configuration and cache into the user profile and refuses to operate with root ownership. If you need a service-like setup, run it under a dedicated non-root user and connect over the desktop session.
dpkg-deb -x extraction sometimes produces a runnable binary but breaks the update path and library assumptions. For anything long-lived, a Debian container or a Debian VM is the honest answer.Headless servers and containers
The client is a GUI application. On a server without X11 or Wayland it will not start, and a container needs an X socket or a VNC session to display anything. If your goal is to automate document generation on a server, the web interface or the API path described in the docs is the workable route, not the desktop package.
Scale settings and font rendering
- On HiDPI displays, the client follows the desktop scale factor. If text looks blurry, check that
GDK_SCALEis not set to a fractional value. - Chinese and Japanese text can render with fallback glyphs on minimal installs — install
fonts-noto-cjk. - Wayland works, but screen capture for the remote-control feature requires the portal permission prompt each session.
Upgrade and remove
sudo apt install --only-upgrade qwenworkcn
sudo apt remove qwenworkcn # keeps ~/.config/QwenWork
sudo apt purge qwenworkcn # removes it tooldd --version.