BT Server

Home

System

Loading…

Last hour

CPUMemoryTemp °C

Collecting data… (a point every 20 seconds)

Server facts

Loading…

Departments

Loading…

Storage by department

Loading…

Signed in now

Loading…

Sign-ups

Loading…

New accounts, last 14 days

Activity, last 24 hours

Loading…

Messages between departments (24 h)

Loading…

Recent activity

Loading…

Users

Inactive

Departments

Status Live

Whole-disk image (SD card)

Image automatically every days starting after keep the last images

A compressed copy of the whole SD card (system, programs, databases, settings) on the USB drive, for rebuilding the server on a new card. It reads the entire card, so expect an hour or two, and the server stays a little slower meanwhile. Normal backups wait until it finishes. Do not restart or update the server while it runs. The image is taken while the server is live, so it is like a power cut at that moment, which the system recovers from on first start. The nightly backup above is the clean copy of the data.

Backup to USB drive

Back up automatically every hours (0 = once a day at the time below) daily at keep the last backups

Saves the databases, code, settings and Git repositories to the USB drive. The drive also holds the server's keys, so keep it somewhere safe.

Active sessions

Activity log

Technical log

Errors only

Add tablet

Open the BT Tablet app on the tablet. It shows a 6-digit code. Enter it here and choose the department. People of that department then sign in on it with their name and PIN.

Code on the tablet

Name

Department

Screen sleep (all tablets)

When nobody is signed in, a tablet lets its screen go to sleep after this long. It stays on the sign-in screen: touch it or press its power button to wake it. A tablet someone is using never sleeps. Needs app 1.4.0 or newer on the tablet.

Sleep after (nobody signed in)

Tablets

Loading…

Inactivity Timeout

Log out after

Log out after this much inactivity. The timer resets on any tap or interaction.

Tap a topic to open its steps.

Find the code

Open your department's code folder (the link at the top of this window).
Use the Go to file button to jump to a file by name, or the search box to find words that are on a screen (for example a button label).
Each file has one job:

Make a change

Open the file and click the pencil (Edit) at the top right.
Change it, then scroll down and click Commit Changes. Choose main for a quick fix, or a new branch if you want someone to look first.
Raise version in manifest.json (for example 1.2.3 to 1.2.4) so admins can see what is running.
The change goes live by itself in about a minute. If the check fails, the old version keeps running and the reason shows next to your change.
Reload the page (and tablets) to see it.

Undo a mistake

Open Commits (history) and click the change you want to undo.
Click Operations, then Revert.
Commit the revert. It goes live like any other change.

Get help from Claude or another AI (nothing to install)

Open CLAUDE.md, click Raw, copy everything and paste it into the AI chat first. This teaches it how BT Server works.
Do the same with the file you want changed.
Say what you want in plain words, and ask for the complete changed file.
Paste the answer back into the editor, commit, then try it.

Get help from Claude Code on your PC (it edits the files itself)

Make a token: your picture (top right), Settings, Applications, Generate New Token. Tick only repository: Read and Write and copy it.
In a terminal run git clone https://bts.tail1027fe.ts.net:8443/bt/dept-<slug>.git. The username is your code-site name and the password is the token. At the shop you can use http://192.168.1.220:3002/bt/dept-<slug>.git.
Open that folder in Claude Code and describe the change. It already reads CLAUDE.md.
When you are happy, ask it to commit and push. The push goes live.

Tips for any AI

One change at a time. Try it before asking for the next.
Ask it to explain what it changed, and read the changes before you commit.
Never paste a token, password or PIN into a chat.
If it says the change needs something outside your folder (logins, permissions, other departments), stop and ask a BT admin.
Never let it delete data or tables unless you say yes.

Password

PIN (4-8 digits)

Department permissions Clear overrides

Each permission comes from the department's member defaults, then the dept-lead bundle. Set Allow or Deny to override it for this person only.

BT Server

Home

Users

Departments

Tablets

Department code

New User

Move tablet to department

New Department