Getting started

This page covers your first visit to the admin app: creating the first admin account, signing in, and opening the TV display. If Beer Menu is not running yet, see Install with Docker first.

Create the first admin

A new Beer Menu has no accounts and no default password. The first time you open the admin app, it asks you to create the first admin. You only see this once.

The Create the first admin form with empty Username, Password and Confirm password fields and a Create admin button.
The first-run form, shown only on a new install.
  1. Open the admin app in your browser.
  2. Type a Username.
  3. Type a Password of 12 to 256 characters, and type it again in Confirm password.
  4. Select Create admin. You are signed in and see the Taps page.

Sign in

The Sign in form with empty Username and Password fields and a Sign in button.
The sign-in form.
  1. Open the admin app in your browser.
  2. Type your Username and Password.
  3. Select Sign in.
  4. If you have set up two-factor sign-in, the form asks for a second factor. Do one of these:
    • Type the 6-digit code from your authenticator app in Authenticator code, then select Verify.
    • Select Use a passkey and approve the prompt on your device.
    • If you have lost your authenticator and passkeys, select Use a recovery code, type one of your saved recovery codes in Recovery code, then select Verify. Each recovery code works only once.

If two-factor sign-in is required for every admin and you have not set one up yet, the app shows "Set up two-factor sign-in" after your password. Add an authenticator app or a passkey there, as on the Two-Factor Sign-In page, to finish signing in.

To sign out, select Sign out at the bottom of the side panel. The buttons above it, Light, Dark and System, change how the admin app looks on this browser.

Open the TV display

The TV display showing four taps: three pint glasses filled to their keg levels with the beer name, style, ABV and IBU under each, and one empty tap.
The TV display with three kegs on tap.
  1. On the TV, open its web browser. A kiosk browser that starts by itself and fills the screen works best.
  2. Go to the same address as the admin app, with /display added at the end, for example http://localhost:8080/display on the computer running Beer Menu.
  3. Leave it open. The display needs no sign-in, updates by itself when you change something in the admin app, and turns pages on its own when there are more taps than fit.