Reference for every option in Settings → Administration → RoomVox.
| Tab | Purpose |
|---|---|
| Rooms | Room CRUD, permissions, room groups |
| Bookings | Approve/decline, list/calendar view, drag-and-drop move |
| Import / Export | Bulk CSV operations |
| Settings | App-wide defaults — room types, email, telemetry, API tokens |
| Statistics | Usage data |
Function: Default value for new rooms' auto-accept toggle.
| State | Behavior |
|---|---|
| ✅ Checked | New rooms confirm bookings automatically when there's no conflict |
| ☐ Unchecked | New rooms mark bookings as Tentative; a Manager must approve |
Each room can override this in its own editor.
Storage: appconfig key defaultAutoAccept ('true' / 'false')
Function: Master switch for all RoomVox email notifications.
When off, RoomVox sends no confirmation/decline/approval/cancellation emails — even if Nextcloud SMTP is configured. Useful during maintenance or initial setup.
Storage: appconfig key emailEnabled ('true' / 'false')
Function: Controls whether weekend days are visible in the booking calendar view.
This is a display setting only — it does not prevent weekend bookings. To restrict bookings to weekdays, use Availability Rules on individual rooms instead.
Function: Define the room types users can pick from when creating a room.
Defaults (English):
- Meeting Room
- Rehearsal Room
- Studio
- Lecture Hall
- Telephone Booth
- Outdoor Area
- Other
You can add, edit, remove, or reorder types via drag handles. Types are published as a CalDAV property ({http://nextcloud.com/ns}room-type), allowing calendar apps to filter by type.
Storage: appconfig key roomTypes (JSON array)
Function: Bearer tokens for the Public API.
| Field | Description |
|---|---|
| Name | Free-text label (e.g., Lobby Display) |
| Scope | read, book, or admin |
| Restrict to rooms | Optional — limit access to specific rooms |
| Expires | Optional expiration date |
| Scope | Allows |
|---|---|
read |
List rooms, read bookings, read availability |
book |
Above + create bookings |
admin |
Above + statistics + admin operations |
Tokens are shown once at creation — copy immediately. After creation only the prefix (rvx_xxxx...) is shown.
See Public API and API Reference for details.
Configure Microsoft Graph credentials for bidirectional Exchange sync. See Exchange Integration for the full architecture.
Settings:
| Field | Description |
|---|---|
| Tenant ID | Microsoft Azure tenant ID |
| Client ID | App registration client ID |
| Client Secret | App registration secret |
| Globally enabled | Master switch for Exchange sync across all rooms |
| Inline-sync throttle | Per-room minimum interval between webhook-triggered syncs |
| Inline-sync rate limit | Global rate cap to prevent overload |
Per-room Exchange linking happens in the room editor.
Configure your VoxCloud subscription key for Enterprise activation. Free tier is fully featured up to the volume limit (no feature gating).
| Toggle | Effect |
|---|---|
| Send anonymous usage statistics | Enables/disables daily telemetry |
| Send report now | Manually trigger a report |
See Telemetry for the full data inventory and disable instructions.
| Setting | Scope |
|---|---|
defaultAutoAccept |
App-wide default; per-room override available |
emailEnabled |
App-wide; no per-room override |
roomTypes |
App-wide |
showWeekendsInCalendar |
App-wide display preference |
telemetry_enabled |
App-wide |
| API tokens | App-wide, optionally room-scoped |
| Exchange sync | App-wide credentials + per-room link |
Per-room settings (auto-accept, availability rules, booking horizon, SMTP, Exchange link) live in the room editor — see Managing Rooms.
All RoomVox settings live in Nextcloud's oc_appconfig table (key-value, no custom tables). Inspect with:
sudo -u www-data php occ config:app:get roomvox defaultAutoAccept
sudo -u www-data php occ config:app:get roomvox emailEnabled
sudo -u www-data php occ config:app:get roomvox roomTypes
sudo -u www-data php occ config:app:get roomvox rooms_index
sudo -u www-data php occ config:app:get roomvox room/<roomId>See Backend Architecture for the full storage model.
- Admin Guide — day-to-day administration
- Managing Rooms — per-room configuration
- Public API — API token usage
- Telemetry — data collected