enricobuehler
69fcb6e0b1
Split the docs' single distro×desktop axis (ubuntu-gnome / ubuntu-kde / fedora-kde) into two,
which deduplicates the shared mechanics and scales to distros that run several desktops (Arch):
- Install the host — per distro/OS (ubuntu, fedora, arch, bazzite, steamos-host, windows-host):
GPU driver + package + input group, then a canonical "Configure your desktop" funnel.
- Configure your desktop — per compositor (kde, gnome, gamescope, sway): host.env, compositor
quirks, the headless session, and starting the host.
New shared web-console page (enable · login password · arm pairing) removes the console/password
block that was copy-pasted across all seven host pages. Merged ubuntu-gnome + ubuntu-kde into
ubuntu; renamed fedora-kde to fedora; kept bazzite and steamos-host as dedicated appliance guides
(trimmed of duplication). Moved the KWin headless session, the GNOME EGL/lock traps, and the
gamescope attach/managed model out of the distro pages onto their compositor pages.
Fixed while restructuring: distro-specific paths on kde (kde-desktop-setup.sh is Fedora/Bazzite-only;
the .deb ships host.env.kde under /usr/share/punktfunk-host), the interactive "start the host" step
that was lost in the merge, sway over-claiming Hyprland, and a pre-existing broken anchor in
how-it-works.
Removal of the three old pages was captured by the preceding commit 8ebb614 (a concurrent commit
swept up the staged git-rm); the net docs tree is correct. Fumadocs build + internal link/anchor
check green.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2.7 KiB
title, description
| title | description |
|---|---|
| Forgot your Password? | Where the punktfunk web console login password lives — and how to read or reset it — on each host platform. |
The punktfunk web console (status, paired devices, PIN pairing) is protected by a login password. That password is generated — or, on Windows, chosen — when the console is first set up, and it lives on the host. So if you can't get past the login screen, you recover or change it on the host machine itself, not from the browser.
New to the console? See The Web Console to enable it and arm pairing.
This is only the web console login. It is not your client/device pairing — if a client won't connect, that's Pairing, not this password.
Find your host
Find your host platform for exactly where the password lives, then read or reset it below:
| Host | Where the password lives | Section |
|---|---|---|
| Linux packages (apt / RPM / Bazzite) | ~/.config/punktfunk/web-password |
Login password |
| SteamOS (host) | ~/.config/punktfunk/web.env |
Login password |
| Windows host | %ProgramData%\punktfunk\web-password |
Login password · Windows Host |
The short version
Linux packages (apt / RPM / Bazzite). The password is generated on first start and saved to
~/.config/punktfunk/web-password. Read it back:
# from the init service's journal (printed once, when it was generated):
journalctl --user -u punktfunk-web-init | sed -n 's/.*password generated: //p'
# …or straight from the file:
sed -n 's/^PUNKTFUNK_UI_PASSWORD=//p' ~/.config/punktfunk/web-password
Change it by editing that file (PUNKTFUNK_UI_PASSWORD=<your-password>) and restarting the console:
systemctl --user restart punktfunk-web.
SteamOS / Steam Deck. Same idea, but the installer writes it to ~/.config/punktfunk/web.env
and prints it at the end of the install run:
sed -n 's/^PUNKTFUNK_UI_PASSWORD=//p' ~/.config/punktfunk/web.env
Edit that file and systemctl --user restart punktfunk-web to change it.
Windows. You pick the password during install (a secure random default is pre-filled and shown
on the installer's final page). It lives in %ProgramData%\punktfunk\web-password. To change it,
edit the file and restart the PunktfunkWeb task — in an elevated PowerShell:
notepad "$env:ProgramData\punktfunk\web-password" # set PUNKTFUNK_UI_PASSWORD=<your-password>
schtasks /End /TN PunktfunkWeb; schtasks /Run /TN PunktfunkWeb
Still stuck? See Troubleshooting.