Forgot your Password?

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 it back or change it below:

Read it back, or set your own

The password is stored on the host as a PUNKTFUNK_UI_PASSWORD=… line, so you can read it straight out of the file. On the Linux packages and the SteamOS host:

sed -n 's/^PUNKTFUNK_UI_PASSWORD=//p' ~/.config/punktfunk/web-password   # Linux packages
sed -n 's/^PUNKTFUNK_UI_PASSWORD=//p' ~/.config/punktfunk/web.env        # SteamOS host

On a Windows host, from an elevated PowerShell (the file is readable only by Administrators and SYSTEM):

Get-Content "$env:ProgramData\punktfunk\web-password"

To replace it with one you pick, follow Login password. It has the exact edit-and-restart steps for each of the three platforms above, and it's the one place that procedure is kept up to date.

The password is right and it still won't let you in

The login screen says "Wrong password." for every failure, including two that have nothing to do with the password you typed.

• Too many attempts. Five wrong guesses from the same device are free; every one after that arms a lockout that doubles — a second, two, four — up to five minutes. While it holds, even the correct password is refused. Wait it out, or clear it at once by restarting the console (the lockout is only kept in the console's memory):

  systemctl --user restart punktfunk-web

  punktfunk-host service restart

  (The PowerShell one is Windows, from an elevated prompt — the console runs under the Punktfunk Host service there.)

• No password is configured at all. If the file is missing or empty, or a line lost its PUNKTFUNK_UI_PASSWORD= prefix, the console fails closed and admits nobody — a page you open answers auth not configured: set PUNKTFUNK_UI_PASSWORD. Put the line back — PUNKTFUNK_UI_PASSWORD=<your-password>, on its own line, nothing else on it — and restart the console as above. On the Linux packages you can instead delete ~/.config/punktfunk/web-password and run

  systemctl --user restart punktfunk-web-init punktfunk-web

  which generates a fresh password, prints it to the journal, and starts the console with it — read it back with the command above.

Still stuck? See Troubleshooting.