TREK

TREK is a self-hosted, real-time collaborative travel planner — with maps, budgets, packing lists, a journal, and AI built in.

Features

• Trip planning — drag & drop day planner, interactive Leaflet/Mapbox map with 3D buildings, route optimisation, weather forecasts
• Travel management — reservations (flights, hotels, restaurants), budget tracking with multi-currency, packing lists, document attachments, PDF export
• Collaboration — real-time WebSocket sync, multi-user trips with role-based access, invite links, SSO (OIDC), 2FA, chat / notes / polls
• Mobile & PWA — installable on iOS/Android, offline support via Service Worker, native-feel UI
• Addons — Lists, Budget, Documents, Collab, Vacay, Atlas (world map of visited countries), Journey (travel journal), Naver List import, MCP
• AI / MCP — built-in OAuth 2.1 MCP server with 150+ tools, 27 scopes, pre-built prompts (trip-summary, packing-list, budget-overview)
• Admin — dashboard views, dark mode, 15 languages, auto-backups, users / invites / templates / API keys management

First Boot

On first start TREK seeds an admin account:

• If ADMIN_EMAIL / ADMIN_PASSWORD are set, those credentials are used.
• Otherwise, the generated credentials are printed to the container log — check the Logs tab of the service.

Environment Variables

Set these from the service's Variables tab if you need them.

Variable	Description
ENCRYPTION_KEY	At-rest encryption key for stored secrets (API keys, TOTP, SMTP, OIDC). Pre-set by this template; if you remove it, TREK auto-generates one and persists it to /app/data/.encryption_key.
ADMIN_EMAIL	Email for the seeded admin account (first boot only).
ADMIN_PASSWORD	Password for the seeded admin account (first boot only).
JWT_SECRET	Optional. Signing secret for session tokens; auto-generated if unset.

Additional configuration (SSO/OIDC, SMTP, Mapbox / Google Places API keys, addons, backups) is managed from the in-app Admin panel after deployment.

Persistence

Two volumes are mounted to preserve your data across restarts and redeploys:

• /app/data — SQLite database, encryption key, JWT secret
• /app/uploads — user-uploaded files (documents, photos, attachments)

Source

GitHub Repository · Docker Hub