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

Install, update and remove the app on Windows

There's no public download of the Windows app yet. The files come from Bouncer's private release (Get Bouncer says where they are and who can get them). There are two ways to install it. If you're not sure, use the installer (MSIX). Use the portable ZIP only if you can't get administrator rights on the PC for the one-time certificate step, or if your organisation's IT policy blocks installing app packages from outside the Microsoft Store.

Installer (MSIX)Portable ZIP
Administrator rights on the PCYes, once: someone with administrator rights on the PC trusts S6 Studios' certificateNo
Start menu entryYesNo
Starts in the tray when you sign inYes (you can turn it off)Only if you add a shortcut
UpdatesFrom its update link, if you installed it that wayNever; download each new version
Remove itSettings > AppsDelete the folder

Use one or the other, not both. The installer can pick up a pairing the ZIP left on the PC, so the two can end up as the same device on your server, and revoking one would revoke the other. To move from the ZIP to the installer, follow the steps under Update.

What you need

  • Windows 11, 64-bit (x64).
  • The files from the release: bouncer-windows-x64-<version>.msix, the certificate bouncer-beta-signing.cer, SHA256SUMS and bouncer-windows-install-instructions.md, or the ZIP bouncer-windows-x64-<version>.zip and SHA256SUMS.
  • To approve on this PC (rather than only see requests): Windows Hello with a PIN, a TPM security chip (most PCs sold with Windows 11 have one), and a server that accepts Windows Hello keys. Servers don't by default, so ask your administrator. See Approve on Windows.

Install with the MSIX

1. Check the files

In PowerShell, in the folder with the files:

Get-FileHash -Algorithm SHA256 .\* | Format-Table Hash, Path

Each hash should match that file's line in SHA256SUMS. SHA256SUMS lists every file in the release, so it has lines for files you didn't download too. (bouncer-windows-install-instructions.md may call it SHA256SUMS.txt. Use the release's SHA256SUMS; its lines for the Windows files are the same.)

2. Trust S6 Studios' certificate (once per PC)

The installer is signed with S6 Studios' own certificate. S6 Studios makes Bouncer. The certificate isn't from the Microsoft Store or a public certificate authority, so Windows has to be told to trust it once. This needs administrator rights on the PC. If you don't have them, ask your IT team to do this step.

Open Terminal (Admin) (right-click Start), go to the folder, and run:

Import-Certificate -FilePath .\bouncer-beta-signing.cer -CertStoreLocation Cert:\LocalMachine\TrustedPeople

Check that the thumbprint it prints matches the one in bouncer-windows-install-instructions.md. If it doesn't, stop: the file isn't the one that was published.

Trusted People lets Windows accept app packages signed by this one certificate. It doesn't make it a certificate authority for anything else. Don't put it in Trusted Root Certification Authorities.

3. Install

In a normal (not administrator) window, double-click the .msix file and choose Install, or run:

Add-AppxPackage -Path .\bouncer-windows-x64-<version>.msix

If Install is greyed out and App Installer says the publisher certificate couldn't be verified (0x800B010A), do step 2 first.

4. Open Bouncer

Open Bouncer Desktop from the Start menu. You should see Pair this PC. Next: pair the app with your server.

Install the portable ZIP

  1. Right-click the ZIP and choose Extract All. Choose a folder in your own profile, for example C:\Users\alice\Apps\Bouncer. You don't need administrator rights.
  2. Open the extracted Bouncer-<version> folder and run Bouncer.exe. Keep the DLL files and the data folder beside it. Don't run it from inside the ZIP.
  3. The ZIP isn't signed, so Windows may say Windows protected your PC. Choose More info, then Run anyway.

If Windows says a plugin DLL is missing, you ran it from inside the ZIP or copied the EXE on its own. Extract the whole ZIP and run that copy.

To start the ZIP copy when you sign in: press Windows+R, type shell:startup, press Enter, and make a shortcut to Bouncer.exe there. Add --tray at the end of the shortcut's Target to start it in the tray without a window.

How it runs

  • Closing the window keeps Bouncer running in the notification area (the tray). Click the tray icon to open it again. The icon shows how many requests are waiting.
  • To stop it, right-click the tray icon and choose Quit Bouncer Desktop, then confirm. You won't get request notifications on this PC until you open it again.
  • Notifications only come while Bouncer is running. Windows has no push to a closed Bouncer, so requests wait until you start it (they also reach your other paired devices).
  • The installed MSIX starts in the tray when you sign in. To stop that, turn Bouncer Desktop off in Settings > Apps > Startup.
  • While the PC is locked, notifications say only "Access request pending" and "Unlock this PC to see the details".

Update

Bouncer doesn't update itself; Windows does. In Bouncer, open Settings and look under About at Updates. It shows the installed version and how this copy updates:

  • Installed from its update link (a Bouncer.appinstaller file): Windows checks for updates when you start Bouncer (at most every 8 hours), and in the background at other times.
    • If it finds one when you start Bouncer, Windows asks first. Finish Updating installs the update and then opens Bouncer. Open Now opens the version you have straight away and updates in the background. If you close the question with its X, nothing opens; start Bouncer again.
    • Check now, in Bouncer's Settings, checks straight away. If there's an update, it says "Update downloaded. It installs the next time Bouncer Desktop starts."
    • Either way, a running Bouncer is never closed for an update, so an approval you're in the middle of isn't lost.
  • Installed from the MSIX file itself: it says it doesn't check for updates. Install a newer MSIX the same way; it upgrades in place and keeps your pairing. To get automatic updates, install once from the update link if your organisation provides one. Bouncer has no update link yet: it needs a public place to host it, which isn't decided.
  • The portable ZIP never updates. Download and extract each new version.

Move from the ZIP to the installer

Do it in this order, so the installer starts without the ZIP's pairing:

  1. In the ZIP copy of Bouncer, open Settings and choose Sign out, then confirm. This asks your server to revoke the ZIP's device and deletes its pairing from the PC.
  2. Quit the ZIP copy from the tray icon, and delete its folder.
  3. Install the MSIX as described above, and pair it with a new pairing code.

If you pair the MSIX first and then ask your administrator to revoke the ZIP's device, you may revoke the MSIX too, because it can start with the ZIP's pairing.

If a later release is signed with a publicly trusted certificate instead of S6 Studios' own, Windows will treat it as a different app. You'll install it beside this one, pair it again, and then remove the old one.

Remove

Uninstalling doesn't always remove the pairing, so sign out first:

  1. In Bouncer, open Settings and choose Sign out, then confirm. Bouncer asks your server to revoke this PC, then deletes the pairing from the PC. If the server can't be reached, it says so and shows the bouncer-admin device revoke command for your administrator.

  2. Quit Bouncer Desktop from the tray icon.

  3. Remove the app:

    • MSIX: Settings > Apps > Installed apps, find Bouncer Desktop, choose Uninstall.
    • ZIP: delete the folder you extracted, and the folder %LOCALAPPDATA%\S6 Studios\Bouncer.
  4. If you turned on Windows Hello approvals, Windows still keeps a passkey named "Bouncer on DEVICE-NAME", where DEVICE-NAME is the name you gave this PC when pairing. Remove it in Settings > Accounts > Passkeys.

  5. To remove S6 Studios' certificate too, in PowerShell as administrator:

    Get-ChildItem Cert:\LocalMachine\TrustedPeople, Cert:\CurrentUser\TrustedPeople |
      Where-Object Thumbprint -eq '<thumbprint from bouncer-windows-install-instructions.md>' | Remove-Item
    

If you already uninstalled without signing out, delete %LOCALAPPDATA%\S6 Studios\Bouncer if it's there, and ask your administrator to revoke the PC on the server.

The ZIP also leaves three small registry entries for notifications, under HKEY_CURRENT_USER\Software. They do nothing once Bouncer is gone; the README-windows.txt in the ZIP lists them if you want to delete them.

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