Home
TREK is a self-hosted, real-time collaborative travel planner licensed under AGPL-3.0.
- Drag & Drop Planner — organize places into day plans with reordering and cross-day moves
- Interactive Map — Leaflet map with photo markers, clustering, route visualization, and customizable tile sources
- Place Search — Google Places (photos, ratings, hours) or OpenStreetMap (free, no API key needed)
- Day Notes — timestamped, icon-tagged notes per day
- Route Optimization — auto-optimize place order and export to Google Maps
- Weather Forecasts — 16-day forecasts via Open-Meteo (no API key required), historical climate averages as fallback
- Reservations & Bookings — track flights, accommodations, restaurants with confirmation numbers and file attachments
- Budget Tracking — category-based expenses with pie chart, per-person/per-day splitting, multi-currency support
- Packing Lists — category-based checklists with user assignment, templates, and progress tracking
- Document Manager — attach documents, tickets, and PDFs to trips, places, or reservations (up to 50 MB per file)
- PDF Export — export complete trip plans as PDF with cover page, images, and notes
- Real-Time Sync — WebSocket-based live sync; changes appear instantly for all connected users
- Multi-User — invite members with role-based access
- Invite Links — one-time registration links with configurable max uses and expiry
- OIDC SSO — sign in with Google, Apple, Authentik, Keycloak, or any OIDC provider
- Two-Factor Authentication — TOTP-based 2FA with QR code setup
- Public Share Links — share a read-only view of any trip
- Lists — packing lists and to-dos with templates, member assignments, optional bag tracking
- Budget Planner — expense tracker with category breakdown, splits, multi-currency
- Documents — file manager for trips, places, and reservations
- Collab — group chat, shared notes, polls, day-by-day attendance
- Vacay — personal vacation day planner with calendar view, public holidays, and carry-over tracking
- Atlas — interactive world map, bucket list, travel stats, continent breakdown
- Journey — magazine-style travel journal with entries, photos (via Immich/Synology Photos), maps, and moods
- Naver List Import — import places from shared Naver Maps lists
- MCP — expose TREK to AI assistants via the Model Context Protocol (OAuth 2.1)
Dashboard widgets (currency converter and timezone clock) are per-user preferences, not an admin-toggleable addon — see Dashboard-Widgets.
- MCP Server — built-in Model Context Protocol server with OAuth 2.1 authentication
- 150+ Tools — create trips, plan itineraries, manage budgets, send messages, and more
-
30 Resources — read-only
trek://URIs for trips, days, places, budget, packing, journeys, and more - 27 OAuth Scopes — granular permissions across 13 permission groups
-
Pre-built Prompts —
trip-summary,packing-list, andbudget-overviewcontext loaders
- User management, invite links, packing templates, global categories
- Addon management, API key storage, scheduled auto-backups
- System notices for onboarding and announcements
Admin: Most configuration lives in the Admin Panel. On first boot TREK seeds an admin account automatically — credentials come from
ADMIN_EMAIL/ADMIN_PASSWORDif set, otherwise a random password is printed to the container log.
| Quick Start | Install in minutes with a single Docker command |
| My Trips Dashboard | Start planning your first trip |
| Admin Panel | Configure your instance |
| MCP / AI Integration | Connect Claude, Cursor, or any MCP client |
| Contributing | Guidelines for submitting pull requests |
| Development Environment | Set up a local dev environment |