Trellis Tools · Walkthroughs

Walkthroughs › Booking

Booking

Book it before you use it, and give the time back

Read an instrument's week, book a slot and tag the people with you, let the calendar find an hour that fits, change or cancel, see your bookings waiting on your notebook day, and — as a lab admin — add equipment and set its rules. Every step uses the demo's rooms and instruments, so what you see on your screen matches the recordings here.

Versions Recorded on 13 November 2026 with Trellis 2.49.2 and Booking 0.5.0. Yours are under About in the tool's own header. If yours are newer, a screen here may have moved on; if they are older, something on this page may not be there yet.

Before you start

  1. Have Trellis running: on a lab server, or on your own computer for practice (install).
  2. Load the demo. It adds two teaching labs, their accounts and example work in every module, and leaves your lab's own records alone. On the server, in the Trellis folder:
    demo/demo.sh load
  3. Sign in as demo, password trellis-demo (or the one set with DEMO_PASSWORD).

To start the walkthrough again from a clean slate, run demo/demo.sh reset. The recordings are silent; each step is named in the green caption at the bottom.

1

The calendar

One week of one instrument, with who has what and what it is for.

  1. On the Trellis home page, click Booking.On the left: everything your labs share, grouped by kind — meeting rooms, microscopes, thermocyclers. The search box finds one by name or room.
  2. Click Confocal microscope (Leica SP8).Its week, with today marked and a red line at the time now. The header says where it is and its rules: *round the clock* here.
  3. Use ‹ and › to change week, Today to come back, or the date box to jump.
  4. Click All microscopes for everything of that kind side by side, for one day.The quickest way to see what is free where several things of one kind are shared — four growth chambers, say. The key at the bottom marks yours, someone else's, and closed or unavailable time.

Each booking says what it is for and who made it, so someone who needs the instrument knows whether to ask. demo +1 means one other person is tagged in it.

Recording · The calendar
RecordingAn instrument's week, then all microscopes side by side for one day.
Booking
What your labs share, grouped by kind.
A week
Its week, with today marked.
All microscopes
Everything of one kind, for one day.
2

Book a slot

Book what you need, say what it is for, and tag whoever is with you.

  1. Click an empty slot in the calendar, or drag down it for a longer one. + Book does the same.The instrument, the day and the time are filled in from where you clicked.
  2. Check the start and end, then say what it is for in What for.Imaging T3 roots, RFP is useful; booking is not.
  3. In People in it, add whoever is taking part: demo-partner.They appear as a chip. It then shows under their My bookings and on their Lab Notebook day, so a session with a student or a visitor is on everybody's calendar without a second booking.
  4. Click Book.It appears in the calendar in that instrument's colour, marked +1 for the person tagged, and under My bookings.

Tagging someone does not let them change it. The booking stays with whoever made it, and with the instrument's managers.

Maintenance or a service visit? Tick Mark it unavailable: the time is blocked and nobody can book it.

Refused? The calendar says which rule it ran into: the step size, the shortest or longest allowed, how far ahead, the open days and hours, or a clash — and a clash shows whose booking it is, so you can ask.

Recording · Book a slot
RecordingA slot booked on the confocal, with demo-partner tagged in it.
Book
What for, and who is in it.
On the calendar
On the calendar, marked +1.
3

Find a free slot

When what matters is getting an hour on a microscope, not which microscope.

  1. Click the Find a slot tab.
  2. Say the kind of thing you need — Microscope — and where, if it matters.What narrows it further by name or room; Places at least matters where several people share one thing at once, like seats in a meeting room.
  3. Say how long for, 2 h, and roughly when: a date range, and the part of the day that suits.Between is optional: leave it empty for any time the instrument is open.
  4. Click Find free time.Every free slot that fits, across everything of that kind you may book, day by day. Calendar shows one in its week.
  5. Click Book … on the one you want.It is filled in for you; add the title and the people, and save.
Recording · Find a free slot
RecordingTwo free hours on any microscope, over the coming week.
Find a free slot
What kind, how long, roughly when.
Free slots
Pick one and it is filled in for you.
4

Change or cancel

Give the time back as soon as you know: the slot is no use to anyone while it is still yours.

  1. Click the My bookings tab.What is coming, soonest first, each with the instrument, the time, what it is for and who is in it. Tick The past month too to see what has been.
  2. Click Change on one.Its time, its title and who is in it can all be changed; the same rules are checked again.
  3. Click Save, or Cancel booking to free the slot at once.A cancelled booking leaves the calendar but is kept, so it is clear what happened.

A booking that has already started can be ended early by shortening it.

Booked the wrong week? Change its date rather than making a second booking.

Someone has a slot they are not using? Their name is on the booking: ask them. A manager can move it if they cannot be reached.

Recording · Change or cancel
RecordingMy bookings, and a booking opened to change or cancel.
My bookings
What is coming, soonest first.
Booking
Change it, or cancel and free the slot.
5

On your notebook day

A picture in the notebook can be traced to the microscope that took it.

  1. Open the Lab Notebook and press Today.
  2. Look at the top of the page.The bookings you had that day are already there, with the instrument, the room and the time, and a box for what was done. Under them, Coming up: your next bookings.
  3. Write what was done beside each one.Nothing has to be filled in for the bookings to appear: they are simply there.

Tagged in someone else's booking? It shows on your notebook day too.

Clicking the instrument's name opens that week in Booking.

Recording · On your notebook day
RecordingToday's notebook page, with the day's two bookings already at the top.
13-11-2026 Friday
The day's bookings, waiting on the page.
6

Add equipment and set its rules

For a lab's lab admins: what the lab shares, who may book it, and on what terms.

  1. Click the Rooms & equipment tab.Everything your labs offer, with its kind, who it belongs to and is shared with, its rules in short, and how many bookings it has.
  2. Click + Add a room or piece of equipment, or Change on one.Its name; its kind (Meeting room, Microscope, Growth chamber) — free text, but keep to the words already in use, since Find a slot and the day view group by it; where it is; and a colour so it is recognisable in the calendar. In About it, put what people need to know before they book: the rules of the room, who to ask for training, where the key is.
  3. Under Who books it, choose who may see and book it: your own lab, named labs, whole chair groups, or everyone in the suite.Anyone it is shared with can book it; only its managers change its rules or move someone else's booking.
  4. Under Rules, set how many at once, the step size, the shortest and longest booking, how far ahead it may be booked, and its open days and hours.A growth chamber is normally round the clock; a meeting room is not.

Changing a rule does not disturb bookings already made.

Managers are not held to the how-far-ahead limit, so they can book courses and service visits.

No longer in use? Retire it rather than deleting: it leaves the lists, and the bookings made on it stay readable in people's notebooks.

Recording · Add equipment and set its rules
RecordingA meeting room opened: what it is, who may book it, and its rules.
Rooms & equipment
What the lab offers, and to whom.
Change
What it is, and who may book it.
Rules
Steps, limits, and open days and hours.

Where next

  • The Lab Notebook walkthrough starts on the day page where these bookings appear.
  • Booking's own Help page (Help, top right in Booking) lists every rule a refused booking can run into, and what to do about it.