Files and settings

Where things are, and what was tested.

commands and files
CommandWhat it does
waydesk-admin status [--watch]memory, swap, load, the GPUs and how busy they are, running sessions, what each account uses and runs (GPU or CPU, the video encoder); --watch keeps refreshing, --json --watch writes a line of JSON each time
waydesk-admin users ...accounts, passwords, per-account limits; sessions list | end NAME
waydesk-admin access | cert | vpnwho can reach the port, the certificate clients check, a WireGuard VPN
waydesk-setup-adminthe first administrator, and how clients connect
waydesk-setupchoose browsers, office, developer and creative apps (the shell comes with waydesk)
/etc/default/waydeskthe daemon's and the sessions' options
/etc/xdg/waydesk/sway.confthe session's sway configuration

Every command with its real output: the command line; first steps: getting started; when something is wrong: troubleshooting.

Every package, command, unit and file is listed in docs/REFERENCE.md.

Source code and licences

Waydesk is AGPL-3.0-or-later (source on GitHub); the other programs we build keep their own licences, MIT for sway, wlroots, DankMaterialShell, danksearch and dgop. Three copyleft programs are in the repository as binaries, and their source is offered here, from the same place as the packages, at no charge:

  • matugen 4.2.0 (GPL-2.0-or-later), built unmodified from the upstream tag, with its Rust crates
  • quickshell 0.3.0 (LGPL-3.0-only), built unmodified from Debian's copy of the release
  • pcmanfm-qt (GPL-2.0-or-later): the Debian 13 and Ubuntu 26.04 source packages and our two patches (they remove menu entries)
$ curl -fsSL https://waydesk.dev/apt/source/README

Every file is listed with its checksum in SHA256SUMS; the folder has the archives. Each package also carries its licence under /usr/share/doc/<package>/copyright.

Key

Packages and indexes are signed with one ed25519 key, fingerprint C64672B25ECD4773196C39589D8E8874E67617F4, expires 2029-10-21. The public key is /apt/waydesk-archive-keyring.gpg.

This page is a file in the repository: corrections are welcome.