Maurice
0a824cec84
Includes the tab ids the ?tab= parameter takes - they are the historic German names, which is not something anyone would guess. That matters for the people who asked: a shortcut or a browser wrapper can point at a tab without the setting at all.
2.9 KiB
FAQ
Do I need a Google Maps API key?
No. When no Google Maps key is configured, TREK automatically falls back to OpenStreetMap (Nominatim) for place search — no API key or account required. If you want richer place data (photos, ratings, opening hours), an admin can optionally add a Google Maps key in User Settings.
Can I use TREK offline?
Yes. TREK is a Progressive Web App. After your first visit, the service worker (powered by Workbox) caches map tiles (Carto and OpenStreetMap), non-sensitive API responses, uploaded covers and avatars, and all static assets. Subsequent visits work without a network connection for already-cached content. See Offline Mode and PWA for installation instructions.
Note: Auth, admin, backup, and settings endpoints are intentionally excluded from the offline cache.
How many MCP tokens can I create?
Each user can create up to 10 static API tokens. Static tokens are deprecated — migrate to OAuth 2.1 when possible.
For OAuth 2.1, each user can register up to 10 OAuth clients. The default limit for concurrent MCP sessions is 20 per user (configurable via MCP_MAX_SESSION_PER_USER). See MCP Setup.
Admin: MCP must be enabled in Admin Panel > Addons before any user can access it.
Where is my data stored?
| Type | Path |
|---|---|
| Database | ./data/travel.db (SQLite) |
| Uploads | ./uploads/ |
| Logs | ./data/logs/trek.log (auto-rotated) |
| Backups | ./data/backups/ |
When running in Docker, mount ./data and ./uploads as volumes so your data survives container updates. See Install: Docker Compose.
How do I update TREK?
Pull the new image and recreate the container. Your data is in the mounted volumes and is never modified by the update process. See Updating for the exact commands.
Can I restrict who can register?
Yes. An admin can disable open registration so that new accounts can only be created via invite links. See Admin: Users and Invites.
Does TREK support single sign-on?
Yes, via OpenID Connect (OIDC). Compatible providers include Google, Authentik, Keycloak, and any standard OIDC-compliant IdP. Set OIDC_ONLY=true to disable password login entirely. See OIDC SSO.
Can TREK open straight on my trip instead of the dashboard?
Yes. In Settings → General → Startup, set the start page to Active trip and pick the tab it should open on — Costs, for instance, if you mostly add expenses while travelling. Opening TREK (including the installed PWA or a home-screen shortcut) then goes there in one step instead of three.
If you would rather build the shortcut yourself, or point a wrapper app at it, any trip URL takes a tab directly: /trips/42?tab=finanzplan. See Display-Settings for the full list of tab ids.