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

Frequently asked questions

About Bouncer

What is Bouncer?

An approval system for access to secrets. A person, script or AI agent asks your organisation's Bouncer server for a secret, an API key or SSH access. An approver gets the request in the Bouncer app and approves it for a length of time, or denies it. The secrets are kept in OpenBao, not in Bouncer.

How do I get the apps?

Ask your organisation's Bouncer administrator. The Android and Windows apps come from Bouncer's private GitLab release: an APK for Android, or an installer or ZIP for Windows. S6 Studios also has internal test builds on Google Play's internal track and Firebase App Distribution for its own testing. There's no store listing. Get Bouncer says what's in the release.

Then follow Install on Android or Install on Windows, and pair the app with the pairing code your administrator gives you.

Is there an iPhone or Mac app?

Not yet. The iPhone app is in internal testing at S6 Studios, through Apple's TestFlight. A Mac app is in development. Until then, approve on an Android phone or a Windows PC. See iPhone and Mac.

Does S6 Studios see my requests or secrets?

No. S6 Studios makes Bouncer, but your organisation runs its own Bouncer server, and requests, decisions and secrets stay between your devices and that server. On Android, notifications go through Google's Firebase Cloud Messaging, and they carry only random IDs, never the request's details or a secret. On Android, the QR code scanner uses Google's ML Kit, which reads the code on the phone. No camera image leaves the phone, but ML Kit sends Google technical information such as the device model and app version. You can type or paste the pairing code instead. The privacy policy has the details. It's still a draft for owner and legal review.

Approving

How long do I have to answer a request?

As long as your server lets requests wait: 15 minutes by default. The request shows the time left. If nobody answers in time, the request expires and nothing is granted. See Approvals and access duration.

Is the time to answer the same as how long access lasts?

No. The time to answer is how long the request waits. How long access lasts is what you choose when you approve, and it can be shorter or longer than the requester asked for, within the resource's limits.

I approved something by mistake. What do I do?

Open Grants, find the grant and tap Revoke. New reads stop at once. A value that was already read can't be recalled, so if in doubt, change the secret where it's used.

What happens to access when it ends?

Bouncer stops issuing tokens and revokes the ones it issued, so new reads stop. Copies the requester already made, and sessions it already opened (such as a database connection), aren't affected. Bouncer can't recall a secret that has been read.

Can I approve my own requests?

Only if the resource's policy allows it. If it doesn't, the request says "Another approver has to approve this", and you can only deny it.

What does "I don't recognise this" do?

It denies the request and marks it as not recognised in the approval log. Use it when you didn't expect the request at all. The app then shows the commands your administrator can use to revoke that requester's key or end every grant at once.

Can I approve from the notification?

On Android, yes, if you turn on Approve from notifications in Settings and the resource allows it. It approves for the requested duration only. To choose another duration, open the request. Windows notifications only open the request.

What is "Always"?

Standing access with no end time. Your server may offer it: it's in the default list unless your administrator turns it off. Always is experimental and may change or be removed, so choose a time limit instead. If you see standing grants, check them with your administrator. See Standing access.

Devices

What do I do if my phone is lost or stolen?

Tell your administrator straight away. They revoke the device on the server, and it can't approve anything after that. Then pair a replacement.

What do I do when I get a new phone?

Pair the new phone first, then sign out on the old one (Settings, then Sign out). Signing out asks the server to revoke the old phone.

Why don't I get requests on Windows when Bouncer is closed?

The Windows app has no push service. It asks the server for new requests while it's running, in its window or in the notification area (the tray). Quit it, and requests wait until you open it again. They also reach your other paired devices.

Will I lose what I typed if I switch apps?

Not on Android or Windows, from 0.5.2. A credential you're making or editing keeps what you've typed while you switch to another app or minimise Bouncer. By default (Settings > Privacy), values you chose to show are hidden again. Locking your device, signing out or discarding the form clears it. On iPhone it's still cleared whenever Bouncer goes to the background. See If you switch apps while typing.

How do I edit a credential?

Open it in the Library and tap Edit. You only see Edit where you're allowed to save new values from that device. Fields you leave empty keep their current value. See Edit a credential's values.

Do I need a VPN, such as Tailscale?

Not for Bouncer itself. The app needs a network connection that reaches your organisation's Bouncer server, whatever that network is. Some organisations put the server on a VPN; if yours does, connect it first. If the app says it can't reach your server, check the address and your network connection.

Running and integrating

Does the Bouncer server store our secrets?

Not at rest. OpenBao stores the values, and Bouncer's database holds metadata and access records. But the running server handles values in memory when a device views or saves a secret, and when someone creates a personal credential, and its OpenBao role can read paths enabled for viewing and personal credential namespaces. See How Bouncer protects access.

Can an AI agent approve its own request?

No. Agents use a requester key, and a requester key can never approve. Only a signature from a person's paired phone or PC approves. The MCP server has no tool that approves anything. See Connect an AI agent through MCP.

If I revoke a grant, is the secret safe again?

Not if it was already read. A revoke stops new token issuance at once and asks OpenBao to revoke the grant's existing tokens; check the result for failures. The kill switch ends every grant and asks OpenBao to revoke every token Bouncer issued. Check its report for any revoke it couldn't confirm. A copied value keeps working until you change it at its source. See Copied secrets and revocation limits.

How do I get a secret into a program without it showing up in ps or my shell history?

Use bouncer exec with --env, --file or --stdin. The value goes straight to the command, rather than into its arguments. Check the command's output with fake data first; see Patterns for workloads and agents.

Does Bouncer support single sign-on?

Not in this version. People are listed in the server's config file, and each person proves who they are by holding a device paired as them. See Known limits.

Does Bouncer need to be on the internet?

No, and it shouldn't be. Put it on a network only your people and machines reach (a LAN, or a VPN such as Tailscale), with HTTPS in front. Phones and requesters reach it over that network. See TLS and networking.

What happens if the Bouncer server goes down?

Nobody can get new access until it's back. Tokens already issued keep working for the few minutes they last. Revocations recorded before the outage are retried when it returns. See Health checks.

Can I run Bouncer with more than one server for high availability?

Not in this version. It's a single server with one PostgreSQL database. Back it up regularly (Backup and restore).

What if someone loses their phone?

Revoke the device with bouncer-admin device revoke, then decide about the grants it approved. See Recovery.

Is there a Windows or macOS command-line client?

Yes for Windows: from 0.5.1, bouncer and bouncer-mcp run natively on x86_64 Windows, from a zip that isn't code-signed yet. There's no macOS CLI. See Install the CLI.

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