Skip to main content

Open DeskDesk for the first time

A first look at DeskDesk — where the app lives, what the navigation gives you, and how to tell it is wired up to OpenRegister.

Goal​

By the end you will have opened DeskDesk, recognised the dashboard, the floor plan and the booking list, and confirmed that the OpenRegister-backed lists (Desks, Bookings, Floors) load.

Prerequisites​

  • A Nextcloud account on an instance where the DeskDesk app is installed and enabled.
  • The OpenRegister app installed and enabled — DeskDesk stores everything (desks, floors, zones, bookings, knowledge sources) in OpenRegister, so it is a hard dependency.
  • At least one floor with desks configured by an admin — see Set up floors, zones and desks. Without that, the floor picker is empty and the booking dialog has nothing to book.

Steps​

  1. Open the Nextcloud app menu in the top bar and pick DeskDesk. You land on the dashboard / desks index.

    DeskDesk dashboard

  2. Read the dashboard tiles — occupancy, My bookings, Popular zones. On a fresh install they read 0; they fill in as people book.

    Dashboard tiles

  3. The in-app navigation has three top-level entries — Desks (the home / floor plan), Bookings (your booking history), Floors (admin view of the building). Below the divider sit Settings and the link to the Nextcloud admin settings page.

    DeskDesk navigation

  4. Click Bookings. The list view shows every booking on the instance (filtered by My bookings by default). An empty install reads No items found — expected until someone books.

    Bookings list, empty state

Verification​

You are set up correctly when: the DeskDesk dashboard renders without an error banner, the navigation lists Desks, Bookings, Floors, and clicking Bookings shows either rows or a clean No items found state — not a load error.

Common issues​

SymptomFix
"OpenRegister is not installed or enabled" bannerInstall and enable the OpenRegister app, then reload DeskDesk.
Floor picker is emptyNo floors configured — an admin sets up at least one (see Floors, zones and desks).
DeskDesk is missing from the app menuThe app is not enabled for your account — ask an administrator to enable it (and check it is not restricted to a group you are not in).

Reference​