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.
Use the apps
The Bouncer app is where people answer access requests. You can also ask for access yourself, see the access you've approved and end it early, and, where your organisation allows it, look at or save a credential.
Before you start
You need three things:
- A Bouncer server run by your organisation. The app doesn't work on its own. Your organisation's Bouncer administrator sets up the server and adds you to it as a person who can approve, ask for access, or both.
- A network connection that reaches that server. That may be your office network, the internet, or a VPN, depending on how your organisation runs Bouncer. The app doesn't need any particular network product. If your organisation uses a VPN for Bouncer, connect it first.
- A one-time pairing code from your administrator. They make it with
bouncer-admin device pairon the server. It works once and only for a few minutes.
On Windows, "tap" means click.
The tasks, in order
- Install the app on your device: Android, Windows, or see iPhone and Mac for where those stand. Get Bouncer says where the files are today.
- Pair the app with your server. This registers the device with the server. A phone makes its approval key as it pairs; a Windows PC makes one later, when you turn on Windows Hello.
- Answer requests. Approve for a length of time you choose, or deny.
- Understand approvals and access duration. The time to answer and the length of access are different things.
- See and end access you've approved, in Grants.
- Ask for access yourself, if your administrator lets you.
- View, save and share credentials in the Library, where your server allows it.
- Replace, lose or remove a device, including signing out and switching servers.
- Fix common problems.
What each app can do
The Android and Windows apps come from the private GitLab release. The iPhone app is in internal testing, and the Mac app is in development, so neither is available to install yet. Platforms and status has the status of each.
| Android | Windows | |
|---|---|---|
| See requests, grants and your own requests | Yes | Yes |
| Approve and deny | Yes | Yes, if the PC has a TPM and your server accepts Windows Hello keys. Then turn on Windows Hello. |
| Pair | QR code or pairing string | Pairing string |
| Notifications | Push notifications, even when the app is closed | Windows notifications, only while Bouncer is running (in the window or the tray) |
| Approve from a notification | If you turn it on, and your server allows it | No |
Words used in the app
A few words come up everywhere. The glossary has more.
- Requester: whoever asks for access. It can be a person, a script or host, or an AI agent. Each has its own requester key, issued by Bouncer.
- Approver: a person allowed to approve or deny requests for a resource.
- Resource or credential: the thing being asked for, such as a stored secret, an API key or SSH access to a host.
- Grant: the access you approved. It has an end time, and you can revoke it before then.
- Approval key: a key your device makes and keeps (a phone when you pair it, a PC when you turn on Windows Hello). The app signs every approval and denial with it, so the server knows the decision came from your device.