Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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

Support

Draft. The support contact details and how quickly we reply aren't decided yet, so this page shows placeholders such as <SUPPORT_EMAIL> where they will go.

Bouncer is the approval app for a Bouncer server that your organisation runs. If something's wrong with your access itself (who may ask for what, or a device you've lost), your organisation's Bouncer administrator can help fastest. For problems with the app, email <SUPPORT_EMAIL> and say which device and app version you have (shown near the bottom of Settings).

Don't send secret values, pairing codes, pairing strings, the keys your scripts or agents use to ask for access, or screenshots that show any of them. The FAQ answers the common questions.

Getting started

  1. Ask your administrator to run bouncer-admin device pair for you. It shows a QR code and a pairing string. The pairing string is your server's address and a one-time pairing code together, as one line of text; the QR code holds the same thing. Both work once and expire after a few minutes.
  2. On a phone, tap Scan QR code, or Enter the code instead and paste the pairing string. On Windows, copy the pairing string and click Paste pairing string, or type the server address and the pairing code separately.
  3. Check the server and your name, name the device, and tap Pair.
  4. On a phone, allow notifications when asked, so you hear about new requests. On Windows, Bouncer waits in the notification area and shows a Windows notification while it's running. If you quit it, it can't tell you about new requests until you start it again.

The device needs a network connection that reaches your Bouncer server. Some organisations put the server on a VPN to keep it off the open internet. If yours does, connect it first.

Common problems

"Can't reach your Bouncer server." The device can't get to the server. Check your network connection (and your VPN, if your organisation uses one for Bouncer), and that the address is right. Nothing is approved or changed while the app is offline.

"This code has expired or was already used." Each pairing code works once and only for a few minutes. Ask for a new one.

"Too many wrong codes." Wait a few minutes, then try again with a fresh code.

The camera doesn't open. Allow camera access for Bouncer in the system settings, or use Enter the code instead. The camera is only used to read the pairing QR code. The Windows app doesn't use the camera.

I don't get notifications. Phone notifications only work with a Bouncer server that S6 Studios has set up to send them. Servers run by other organisations can't send them, so open the app to see what's waiting: requests always show in the inbox. If your server does send notifications, check Notification settings in Settings; Android 13 and later ask for permission first. On Windows, Bouncer Desktop shows a notification only while it's running (when it's installed from the Store or an MSIX package, it starts at sign-in unless you turned that off).

A request vanished from the inbox. Requests wait for a limited time. If nobody answers in time it expires and nothing is granted. Whoever asked can ask again.

I approved something by mistake. Open Grants and tap Revoke. Bouncer then stops handing out anything new for that access. Anything it has already handed out, such as a token or a server login, can keep working until it runs out or until the system it opens stops accepting it. A password that was already read can't be taken back, so ask whoever looks after it to change it and to close any logins that used it.

New, lost or retired device

  • Switching to a new phone: pair the new one, then sign out on the old one (Settings > Sign out). Signing out asks the server to remove that device.
  • Lost or stolen phone: tell your administrator straight away. They remove the device on the server (bouncer-admin device revoke), and it can't approve anything after that.
  • Switching servers: Settings > Switch Bouncer server. The app asks the old server to remove this device first.
  • Removing everything: sign out, then uninstall. See the privacy policy for what's kept and where.

Security problems

If you think you've found a security problem in Bouncer, email <SECURITY_EMAIL> (or <SUPPORT_EMAIL>) privately rather than posting it in public. We'll reply within <RESPONSE_TIME, TO DECIDE>.

This manual covers Bouncer 0.5.7. Built from source commit cdd3b5958d5be0b33e865b1b56b770f6bccffaf7 (workspace version 0.5.7+34).