Manual for Bouncer 0.5.7. Chapters state version and distribution limits. Source cdd3b59, site build 20 November 2026. Your server or app may run an earlier version.
On this page
Replace, lose or remove a device
Each paired device has its own approval key and its own entry on your server. Ending a device's pairing (revoking it) stops it seeing or approving anything. You can revoke the device you're holding by signing out. Only an administrator can revoke another device.
Getting a new phone or PC
- Pair the new device with a new pairing code.
- Check it works: open a request on it, or look in its Settings under Your other devices for the old one.
- On the old device, open Settings and tap Sign out, then confirm. Bouncer asks your server to revoke the old device, then removes the pairing and approval key from it.
Pairing first means there's no gap when nobody can approve.
If the old device is already gone (broken, wiped or traded in), ask your administrator to revoke it, as for a lost device.
A lost or stolen device
Tell your administrator straight away. They find the device with
bouncer-admin device list and revoke it with bouncer-admin device revoke.
After that it can't see or approve anything, even if someone unlocks it.
Then:
- Pair a replacement.
- Look in Grants at what the lost device approved. Revoke anything you don't want to keep running. Time-limited grants it approved before it was lost run until they end unless someone revokes them. Revoking the device ends any Always grants it approved.
- If you think someone used it to approve something, tell your administrator.
They can end every grant at once with
bouncer-admin revoke --all.
Someone holding your phone can't approve while it's locked. Once it's unlocked, anyone holding it can approve, unless you chose fingerprint approvals when pairing. That's why revoking it quickly matters.
Sign out
Settings, then Sign out. The app explains what happens:
- Bouncer asks your server to revoke this device, then removes the saved pairing and approval key here. This device stops getting requests.
- If the server can't be reached, the pairing is removed from this device
only, and the device may stay active on the server. The message shows the
bouncer-admin device revokecommand, with this device's ID, for your administrator to run. - Time-limited access this device approved runs until it ends.
After signing out, the app is back at the pairing screen.
Switch to another Bouncer server
Settings, then Switch Bouncer server, then Continue. You need a pairing code from the new server.
Your current pairing stays usable until the new one is verified and saved. Cancelling, or a failed setup, keeps it. After a successful switch, Bouncer asks the old server to revoke this device. If the old server can't be reached, ask its administrator to revoke the device there.
"This phone was removed"
If the app says This phone was removed (or This PC was removed), your server no longer accepts the device: someone revoked it. It can't see or approve requests. If you didn't expect that, check with your administrator. To use the device again, tap Pair again and pair with a new code.
"This phone's approval key is gone"
The server still has an approval key for this device, but the device no longer holds it. This can happen after a system restore. On an iPhone, changing Face ID or Touch ID retires the key. On Android, changing your fingerprints retires a key that needs your fingerprint ("This phone's key stopped working").
The device can't approve or deny until you pair it again, which makes a new
key. Before you tap Pair again, copy the bouncer-admin device revoke
command the app shows, and give it to your administrator, so the old pairing
is removed from the server too.
Remove the app completely
Sign out first, then uninstall. The install pages for Android and Windows have the steps, including the Windows Hello passkey that Windows keeps.