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

Platforms and status

This page says what exists on each platform today. It uses these labels:

  • Beta: a released build, in use for testing.
  • Internal testing: built, and distributed only for S6 Studios' own testing.
  • Blocked: built, but waiting on something outside the code. The Notes say what.
  • In development: being written. Nothing to install yet.
  • Not planned: no work on it for the first release.

Status on 19 November 2026

  • GitLab releases. The private GitLab releases include 0.5.4, 0.5.5 and 0.5.7. Version 0.5.6 was built and tested but has no GitLab release.
  • Google Play. The internal track is for S6 Studios' own testing. It has 0.5.7 as a draft, while 0.5.4, signed by Play, is still the active internal release.
  • Firebase App Distribution. The Android 0.5.7 internal build is distributed for S6 Studios' own testing. It isn't installed on a phone yet, and the App Tester icon check is still pending.
  • TestFlight. S6 Studios installed an earlier iPhone test build (0.5.4+32) from internal TestFlight on a real iPhone, paired it, received a lock-screen notification and approved a request with it. iOS 0.5.7 is in internal TestFlight for S6 Studios' own testing, and hasn't been checked on a real iPhone yet.
  • Windows. The MSIX is signed with S6 Studios' own certificate, not one from the Microsoft Store or a public certificate authority. Enrolling a real PC with a Windows Hello TPM attestation is still pending.
  • Device checks. 0.5.7 hasn't yet been checked on real phones and PCs. That includes the iPhone's reconnecting notice, its Notification settings and push.
  • Store submissions. Nothing has been submitted for review on Google Play, the App Store or the Microsoft Store, and there's no public store listing.

Apps for approvers

PlatformStatusWhat you can installNotes
Android 9 or laterBetaAn APK from the private GitLab release. Firebase and Play internal testing have test builds for S6 Studios' own testing (see above)A copy from Google Play and a sideloaded APK are signed with different keys, so one can't update the other. Install on Android
Windows 11BetaA test-signed installer (MSIX), or a portable ZIP, from the private GitLab releaseRequests arrive only while Bouncer is running, because there's no push to a closed app. To approve, you need Windows Hello with a TPM security chip, and your server has to accept Windows Hello keys (it doesn't by default). From 0.5.7, the server checks a TPM attestation at enrolment when Windows supplies one, but no real PC has passed that check yet, and keys enrolled before it stay unchecked (Device keys). Install on Windows
iPhone (iOS 15 or later)Internal testingNothing yet. iOS 0.5.7 is in internal TestFlight for S6 Studios' own testing (see above)iPhone and Mac
MacIn developmentNothing yet
Linux desktopNot plannedUse the command-line tools on Linux.

Tools for requesters and administrators

ToolStatusWhat you can install
bouncer and bouncer-mcp on Linux (x86_64)BetaA tarball with an installer script, or a .deb or .rpm file, from the private GitLab release. A package repository and the update channel are built and tested, but not published yet.
bouncer and bouncer-mcp on Windows (x86_64)Beta, from 0.5.1A zip with a per-user installer. Not code-signed yet. Install the CLI
bouncer-adminBetaRuns on the Bouncer server's own machine

The server

PartStatusNotes
Bouncer server, with OpenBaoBetaThe Bouncer project's own production server runs build 0.3.8+25. The private 0.5.7 release includes a server image and kit; 0.5.6 is built but has no GitLab release. The source repository is private. You can also build from source. Get Bouncer

Known limits that apply everywhere

  • People are set up in the server's config file. Each person who can approve or ask for access is an entry in the server's configuration. Signing in with an organisation account (for example through Keycloak or another OpenID Connect provider) isn't connected yet.
  • Approving from a notification is Android only. On Windows, a notification only opens the request.
  • Folders can be made, but not renamed, moved or deleted in the apps.
  • Bouncer covers OpenBao secrets and SSH hosts. It works with the secrets kept in OpenBao and with SSH hosts set up for it. It doesn't control access to other systems on its own, and it can't end sessions those systems keep open.

How it was tested

Many features have been checked on Android emulators, a Windows test machine and Apple's iPhone simulator, and a few on real phones and PCs. The release notes say what each release was checked on.

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