Sign in to continue

The Bar

Bar-staff-operated handpulls, taps, and box-cider boxes. Tap a slot to assign a product, swap it, mark line-cleaning, or vacate. The till's Cask / Keg / Box cider pages render these slots in order, so a swap here updates what staff see on the till instantly.

Sign in to view tap banks.

Staff discount

Set the staff discount percentage for each product category. When a manager taps Staff on the till's discount modal, each line on the sale is discounted at its category's rate. Leave blank to use the house default (25%) — set in Settings. 0 means no staff discount on that category.

Deals

Multibuy offers the till applies automatically — ring the items and the saving appears when the count is reached. Any mix of the products in a deal counts. A deal price is final: no staff, manager or percentage discount ever touches a deal line.

Loading…

Members

Loyalty card holders. Manual balance adjustments are recorded against the member with a reason note for the journal.

Customer balances
£0.00
held on account · VAT-exempt until spent
Member balances £0.00
Gift cards (unclaimed) £0.00
#NameEmailDOBBalanceStatusID checkReceipts

Seen today

Every card UID that scanned at any reader today — registered members, deactivated cards, unclaimed gift cards, and unknown cards. Click a row to see what we know about that UID and (where appropriate) register the card to a customer.

UID Status Who / What Scans Last seen Reader

Till settings

Live EPOS tunables from the settings registry (the epos.* keys, and bookings.* for table bookings, in app_settings). Changes apply immediately on the server — no restart; the till picks them up on its next hard refresh. Money values are in pence (e.g. 1000000 = £10,000). Edits require the office PIN.

SettingValueSourceUpdated

Xero — daily takings

Posts each trading day to Xero as one sales invoice (line-level VAT, exact till figures) paid into clearing accounts — the MTD-safe shape. Figures are validated against the Z report to the penny before any post; mismatches refuse to post. Start in dry_run mode: preview a few days, let the accountant bless the account mappings, then set mode to live.

Connection & settings

SettingValueSourceUpdated

Monthly takings for the accountant

One row per trading day: cash (what's banked, after any cashback), card (what SumUp pays), and VAT, with sales inc/ex VAT and gift cards so each row adds up. Every day is checked against its Z to the penny first; if any day fails, no file is made.

Preview / post a trading day

Preview builds the exact invoice + payments and runs the Z tie-out without touching Xero. Post respects the mode setting (dry_run never posts).


        

Posting history

DayStatusInvoiceNetVATWhenError

SumUp account credentials

API key, affiliate key, and merchant code from the SumUp merchant dashboard. Same credentials for every paired Solo. Secrets are masked — click Edit, type the new value, save. Changes take effect immediately.

SettingValueSourceUpdated

SumUp Solo readers

Pair each physical Solo to your SumUp account, then assign it to one or more places that take cards — the kiosk wall, the tip station, or any EPOS till. A Solo can be shared between multiple tills (handy as a fallback when one breaks): payments queue up automatically and start as soon as the Solo is free.

Where readers serve

Every place that can take a card payment. Empty rows mean that surface can't take cards yet — assign a Solo from the Paired Solos panel below, or use Pair / Adopt to add a new one.

TargetAssigned Solos (by priority)

Paired Solos

Physical readers paired with your SumUp account. Click Assign… to change which places a Solo serves.

NameReader IDStatusServesPaired at

Pair a Solo

On the Solo (logged out) → Connections → API → Connect. Copy the pairing code (8 or 9 alphanumeric characters) and paste it below. You’ll pick where it serves on the next screen.

Adopt a reader already on this account

Lists every reader paired to your SumUp merchant account. Useful when a Solo has been paired upstream but we don’t have a local row for it yet — click Register on a row to adopt without re-pairing physically.

Test connection

Verifies your API key works and reports each configured reader’s status. Run this after changing credentials, or any time card payments stop working.

WiFi

Pi 5 only. Uses host nmcli via nsenter — on a non-Pi dev box this tab will error.

Current connection

Loading…

Scan & connect

SSIDSignalSecurity

Untappd For Business

Untappd integration has two halves. Search & import uses the read-only token to find beers and prefill the editor (ABV, style, tasting notes, pumpclip). Wall sync uses the read+write token to push beer changes back to your UTFB Wall menu so the public TV updates automatically — pump 1 at the top, pump 10 at the bottom.

Credentials

Find these at business.untappd.com → Account → API Access Tokens.

No locations selected yet.

Wall sync

Mirror kiosk beer assignments onto your UTFB Wall menu. Pump number determines order: pump 1 is top, pump 10 is bottom. Each beer needs an Untappd ID (set automatically when you import from Untappd in the beer editor).

Loading status…
Advanced: menu/section IDs

Defaults match The Rock account. Change only if your Wall menu is at a different ID.

Bar sync

The till keeps the Bar menu's three sections (Cask / Keg / Cider) in step with its taps by tap number: Cask 3 on the till is the item with tap number 3 in the Cask section. A new beer on a tap replaces that tap's item, a price change updates it, an emptied tap removes it. Items with no tap number are never touched, and the till never creates one without a tap number. Each beer needs an Untappd ID (picked in the till's tap wizard).

Loading status…
Sync log (latest first)
Menu/section IDs (required)

The Bar menu has three sections (Cask / Keg / Cider) — one per bank. A bank whose section ID is blank simply doesn't sync. There are no defaults: set this venue's own IDs.

Fridge sync

Mirror the bottle and can products onto the UTFB Fridge menu. Each product writes one container at its configured size (e.g. a 330ml bottle product writes a "330ml Bottle" container at the product's price).

Loading status…
Menu/section IDs (required)

The Fridge menu has two sections (Bottles / Cans). Defaults below match The Rock account.

Wine sync

Push wine prices (125ml / 175ml / 250ml / 75cl bottle) to your UTFB Wine menu. Update-only — create new wines on UTFB first, then run reconcile to link by name.

Loading status…
Menu/section IDs (required)

Defaults below match The Rock account.

Raw probe

Send a GET request to UTFB with our auth header attached. For diagnosing the API. Common paths: /current_user, /locations, /locations/<id>/menus, /locations/<id>/items/search?q=ostara.

SMTP server

Outgoing mail server credentials. The password is masked — click Edit, type the new value, save. Changes take effect on the next email; the transporter cache invalidates automatically.

SettingValueSourceUpdated

Outgoing emails

Each row is one outgoing email. Enable, set who gets it, and how often. Schedules read live — change a time and it takes effect on the next minute.

Daily summary email

Sent automatically after each Z-read close. Owner sees yesterday's takings, top sellers, cash position, and anything that needs attention (variance, missing cashup, refusal count).

Settings

Preview

Send a real email

Use this to verify the email actually arrives. Sends today's data (or whichever day you pick above). Leave the override blank to use the configured recipients.

Send a test email

Sends a test email using the current SMTP settings. Useful after editing credentials to confirm they work before relying on them.

Wall — licensing hours

Hours when the self-pour wall is allowed to dispense alcohol. Outside these times the wall shows a "Bar closed until X" overlay AND the server refuses pour requests at the API layer. Edit a day's open/close times below and Save.

Current status

Loading…

Schedule

Up to two sessions per day (e.g. lunch service + evening). Toggle the "Closed all day" box for any day the bar wall doesn't serve at all (e.g. private events). Times in 24-hour format. A close time before the open time means the session wraps past midnight (e.g. open 22:00, close 02:00).

Card readers (Till Companions)

Each Till Companion (a small Pi with a USB card reader at the bar or cafe) sends card taps to the server tagged with its reader id. Bind a reader to a till here so its taps go to the right place. Swap a Companion? Just re-point the binding — no need to touch the device.

Current bindings

Reader idBound to tillLabelLast seen
Loading…

Add / update a binding

Live activity

Real-time view of what the kiosk is doing. Polls once a second while this tab is open. The active-pour card ticks live as flow-meter pulses come in — useful for calibration and diagnosing “why didn’t my pour finish”.

Now pouring —
Idle — no pour in progress.
Hardware: —
Server time: —

Recent pours

Time Member Pump Beer Measure Pulses Status Charged
loading…

Security & PINs

The office PIN protects edit/delete on cash-up records, settings changes, and admin endpoints. Engineer recovery PIN (2416) is hard-coded — never displayed, never editable; use it to recover if the office PIN is lost.

RoleStatus

What's On

Messages and adverts for the website and the beerboard, in one planner (also in the Boar Dash app): scrolling text and full-screen adverts, in the order they will appear. Set a start and an end and an item shows up on the day and removes itself after — nobody has to remember. Leave the dates blank for something that always shows. Tick which screen it belongs on: the website's banner, the beerboard wall, or both.

Only on:

    Errors

    Faults nobody on the floor can see: server errors, tickets that didn't print, emails that didn't send, backups, stuck card top-ups, member balances that don't match their history, wall pours that went wrong. The same fault counts up on one line. Checks run every 5 minutes and clear themselves when the problem goes; mark the rest resolved once you've dealt with them.

    Loading…

    UPS & power cuts

    The UPS on the NUC, read over its USB cable. On a power cut the tills show AC LOST and a bar (FULL · FAIR · LOW · CRITICAL · SHUTTING DOWN); the NUC shuts itself down safely at the low mark. Every cut is logged here so you can see how long the battery really lasts at our load.

    Now

    Loading…

    How long it lasts

    Power cuts

    Backups

    Automatic SQLite backups (intraday / daily / weekly), verified after every write, kept locally, pushed offsite over SFTP and replicated to other estate Pis. The SSH private key stays file-mounted on the server and is never editable here.

    Status

    Loading…

    Restore from a backup

    Pick a backup to restore. The current database is safety-snapshotted first, the chosen backup is integrity-checked, then the server restarts to swap it in — so tills will drop for a few seconds. This replaces all current data with the backup's.

    Loading…

    Schedule & retention

    Offsite SFTP

    Leave host blank to disable offsite push (local + Pi replication still run). The private key is mounted at the path shown — add the public key to the SFTP server's authorized_keys.

    Offsite FTP (web hosting)

    For hosting that gives an FTP account rather than SSH (cPanel). The chosen backups go to folder/daily, folder/weekly on the server, encrypted (FTPS), and the oldest are deleted there once the keep count is reached. Leave host blank to turn it off.

    Staff hours

    "Actual" is the worked time recorded on the rota (drag each shift's actual bar); holiday / sick days are unpaid and excluded. "Hours to pay" defaults to Actual — hand-adjust only for edge cases (cover, no-shows, maternity, etc). You can also confirm & send straight from the Rota page. Set the payroll recipient in Admin → Email → "Staff hours → payroll".

    —
    Staff Type Scheduled Actual Hours to pay Δ Note
    Loading…
    Total — — — —

    Reset & wipe

    Two separate, heavily-guarded operations. Clear sales data wipes trading history but keeps your whole setup. Full factory reset wipes everything — setup, settings, credentials and staff — for moving to a new site or handing the box on. Both take an un-prunable backup first.

    1 · Clear sales data

    Wipes trading history — every sale, tab, payment, kitchen ticket, cash-up, Z-read, audit-log entry, and till session. Keeps products, staff, layouts, settings — your entire configuration. Use it to clear test data before going live.

    What this DOES wipe

    • All sales, tabs, payments, refunds
    • Kitchen tickets + KDS history
    • Cash-up records + Z-reads + X-reads
    • No-sale audit + cash movements
    • Receipt + order number sequences (restart at 1)
    • Till sessions + active members ("seen today")
    • Admin audit log + failed-login records

    What this KEEPS

    • Products, categories, modifier templates, allergens
    • Beers, pumps, taps, SumUp readers, printers
    • Staff, permissions, PINs
    • Rotas + shifts + staff rota tokens
    • Tills, layouts, tables
    • App settings, VAT rates, email rules
    • Refusal log + ID checks (unless you tick the box below)
    • Members + balances (unless you tick the box below)

    ✓ An automatic backup is taken into backups/pre-reset/ before the wipe and is never pruned by retention — it's your get-out clause if you change your mind after.

    Optional extras

    Confirm

    Type the phrase exactly as shown, enter your own PIN (the one you sign in with), and click reset. The PIN is checked freshly here (not the cached session) so this can't be triggered by someone who walked up to a logged-in keyboard.


    2 · Full factory reset — wipes EVERYTHING

    ⚠ This is the migrate-to-a-new-site / decommission button. It wipes the ENTIRE database, not just sales.

    What this wipes — everything the "clear sales data" button keeps

    • All trading data, members, balances, compliance logs
    • Products, categories, modifiers, allergens, beers, pumps, taps
    • Tills, layouts, tables, printers
    • App settings + DB-stored credentials (SumUp, SMTP, backup/SFTP)
    • SumUp reader pairings
    • All staff accounts, permissions, rotas

    ✓ A pre-reset backup is taken first (un-prunable, in backups/pre-reset/).
    ✓ A bootstrap admin is recreated so you're not locked out — log back in as John / PIN 0000 (or your BOOTSTRAP_ADMIN_* env values) and rebuild from there. Change that PIN immediately.

    Note: secrets in the .env file (SumUp API keys, SMTP password, relay/flow/NFC, TLS certs, office PIN) live outside the database and are NOT touched — rotate those separately when moving sites. DB-stored credentials wiped here are all re-enterable in admin (SumUp account, SMTP, Backups pages).

    Confirm full reset

    A deliberately different phrase + a fresh manager-PIN check. There is no undo beyond the pre-reset backup.

    About this server

    Version, uptime, and basic health. Useful when something feels off and you want to know what build is running.

    Version —
    Build —
    Uptime —
    Node —
    Memory (RSS) —
    Database —
    Hardware mode —
    Email enabled —

    Dashboard

    Today's takings at a glance, with weekly + monthly context. Auto-refreshes every 60 seconds.

    Today (so far)
    —
    — transactions
    This week
    —
    —
    Month to date
    —
    —
    Last 30 days
    —
    —

    By till — today

    Loading…

    Weekly cash-up

    Cashup history

    Past cash-up, float, and change records — across every till. Click a row for the full report.

    —
    Date Time Till Type Staff Counted Variance To safe
    Loading…

    Banking

    Cash that went from the safe to the bank. Subtracted from cumulative "to safe" in the safe-balance calculation.

    —
    Banked this week
    —
    —
    Banked all-time
    —
    Date Amount By Reference
    Loading…

    Safe total

    Cash on site, derived live from cashup records, banking entries, and current floats. Refreshes when records change.

    Total on site
    —
    safe + floats + change
    In the safe
    —
    —
    Floats out
    —
    Change box
    —

    Data management

    Download a full backup of the cashup store, or restore from a previous backup. Restore overwrites — a safety snapshot of the current store is written alongside before the swap.

    Weekly report

    Shift-by-shift takings + variances for the week.

    —
    Cash takings
    —
    —
    To safe
    —
    Cash expenses
    —
    Net variance
    —
    Total on site
    —
    —

    Daily cash takings — per till

    TillMonTueWedThuFriSatSunTotal
    Loading…

    Daily variance — per till

    TillMonTueWedThuFriSatSunTotal
    Loading…

    Recent records this week

    DateTimeTillTypeStaffCountedVariance
    Loading…

    Sales reports

    Pick a date range and drill into the numbers. Trading days run 03:00 to 03:00.

    Pick a date range to begin.

    Tills

    Physical till devices. Each one is a tablet running the till SPA. Create a till, get a 6-digit pairing code, then enter that code on the tablet to bind it.

    NameTypeStatusPairingLast seen
    Loading…

    Till display

    How each till looks. Theme is the colour scheme; Screensaver covers the screen after that long with no taps (a tap wakes it — it never interrupts a payment). Changes show on the till straight away.

    TillThemeScreensaver
    Loading…

    Printing & routing

    The whole printing matrix in one place. Printers are physical devices (name them anything). Ticket routing sends each category's dockets to a printer — or nowhere. Tills point at a receipt printer and an origin printer (origin = "here", used by the bar's no-ticket-at-its-own-till rule).

    Printers

    A printer = a name you choose, a protocol, and a host:port. "Suppress at origin" ON (bar) means it prints nothing when rung at its own till — the order-taker is the maker. OFF (cafe, kitchen) means it always prints, because someone else makes it.

    NameProtocolHost:portSuppress @ originStatus
    Loading…

    Ticket routing — category → printer

    Where each category's prep docket prints. "No ticket" = nothing fires (merch, gift cards, member top-ups). A product can still override its category in the Products editor.

    CategoryCodePrints toBehaviour
    Loading…

    Till printer assignment

    Each till's receipt printer (the customer copy) and origin printer ("here" — drives the bar's suppress rule). Many tills can share one printer.

    TillTypeReceipt printerOrigin printer
    Loading…

    Till types

    Reusable layout templates. Each till points at a type and inherits its layout and receipt header style. Multiple tills can share one type — the main bar and a spare bar both use the "Bar" type. Create new types for outdoor bars, festival tents, BBQs.

    NameSlugHeader styleTills usingStatus
    Loading…

    Tables · Floor plan

    One floor plan for the whole venue. Drag tables anywhere to reposition. Click an empty spot to add a table at that point. Click a table to edit its code, name, area, capacity, shape, or to deactivate/delete. The area chips below are informational — areas are tags used for reports and the table modal, not navigation. The till mirrors this layout exactly.

    Loading…

    Staff

    Who can use the till and the back office. Everyone has a 4-digit PIN and an access level from 1 to 6: the higher the level, the more they can do. What each level can do is set below, and it's the same for everyone on that level.

    NameLevelDefault tillStatusPIN set
    Loading…

    Access levels

    Pick a level to see what it can do. Ticks apply to everyone on that level. You can change levels below your own, and only give a level things you can do yourself. Level 6 can always do everything.

    Rotas

    Draft

    Weekly staff schedule. Drag the sliders to set start and finish for each shift; double-click a track to add or remove a shift. The slider snaps to 15-minute increments so the hours add up cleanly.

    Week of …
    Loading…

    Products

    Saleable items — drinks, food, snacks, merchandise. Prices, allergens and best-before dates live here. Cask/keg/cider/bottle/can products unify with the Beers tab in the next ship; for now use Add Beer for those.

    ⇅ Name Group Category Price Allergens BBE Status
    Sign in to view products.

    Modifier groups

    Reusable modifier groups attached to many products. Edit once, applies everywhere. Bespoke per-product modifiers stay on the product editor; this is just the shared library.

    Loading…

    "No" lists

    Per-category removal lists. When staff tap "No" on a basket line, they see this list for the dish's category, and each pick prints red on the kitchen ticket. We add "No" automatically — just type the ingredient (e.g. "beans" becomes "No beans").

    Loading…

    Layouts

    Each till type has one active default layout. The till renders that layout's pages and buttons; if no layout exists, falls back to the legacy category-driven render. Layouts contain pages (think category tabs); pages contain buttons (products, category jumps, system actions, or section headers).

    Loading…

    Till buttons

    Every till, every page. Changes straight away. Prices always show in the basket and on receipts.

    Draught page

    Under the taps: bar snacks first, then the quick picks (best sellers, last 30 days, not draught, not a snack already shown). More than a row of either wraps onto another row, and every row on the page gets a little shorter. No sales in the last 30 days, no quick picks.

    Sign-in screen

    Kitchen

    Editing layout

    Reports

    Money

    Exceptions

    Everything that took money off a sale or out of the drawer without a sale, and every refusal and ID check — by period and till. Training sales are left out.

    –
    Loading…

    Sales journal

    Every completed sale and refund. Defaults to today; change the date range to look back. X reads are manual snapshots; Z reads close the trading day and fire automatically when all tills have been cashed up (or at midnight if any are still pending).

    Today's totals (live)

    Loading…
    Loading…
    Receipt Time Till Staff Lines Payment Total Status
    Loading sales…
    —

    Recent X reads

    Each X read is a permanent snapshot of till totals at a moment in time. The trading day stays open.

    Loading…

    Recent Z reads

    Daily trading-period close. Fires automatically when every till that traded has had its cash counted, or at midnight if any haven't.

    Loading…

    No-sale audit

    Every "no sale" drawer pop is logged here with staff, till, reason, and whether the kick fired. Who can see it is set under Staff → Access levels. Spot patterns: same staff repeating the same reason at unusual hours is the classic theft tell.

    Loading…

    Compliance — refusals & ID checks

    UK alcohol licensing requires you to record refused sales and Challenge 25 ID checks. These logs are append-only — there's no edit or delete. Show this page to a licensing officer on inspection. Default range is the last 30 days; widen it as needed.

    Refusals

    When Reason Staff Till Customer Notes
    Loading…

    ID checks (Challenge 25)

    When Outcome Age ID type Staff Till
    Loading…

    Wastage & ullage

    Record binned stock (waste) and cellar/draught loss (ullage), with a reason and — where the product cost is known — a cost. Logging waste of a stock-counted product also drops its countdown. Use the report to see where money's going.

    Log

    WhenTypeItemQty ReasonCostSale valueStaffFrom
    Loading…

    Loyalty & promos

    "Buy N, get a reward." Use a repeating scheme for the stamp card (e.g. 12 coffees → free coffee) and a one-off, date-boxed scheme for a milestone promo (e.g. 36 pints → free t-shirt). Members earn by tapping their card on a sale — however they pay (cash, card or balance). Rewards are handed over by staff.

    New scheme

    Schemes

    NameEarn onBuyReward TypeWindowStatus
    Loading…

    VAT period figures

    Figures to hand to your accountant for a VAT period — gross, net, and VAT by rate, with refunds netted off and training sales excluded. Top-ups and gift cards are shown separately as deferred (they're liabilities, not VATable turnover until spent). These are figures only — not a filed VAT return or tax advice.

    Privacy / GDPR

    The essentials: hand a member a copy of their data, erase someone who asks (their name and contact details are wiped while the financial record is kept, as the law requires), and tidy away long-dormant accounts. Not legal advice.

    Privacy note

    A short, plain note on what you hold and why — for staff to use when a member asks.

    A member's data

    Retention sweep

    Find members with a zero balance and no activity for the retention period, and anonymise them.