liketrek/TREKPublic

The most complete open-source travel planner: real-time collaboration, bookings, budgets, packing lists, journals, offline PWA, SSO and an AI-ready MCP server, with planet-wide place search and routing built in.

AI summary: A self-hosted travel planner to visually organize trips, track expenses, and manage reservations with AI assistance.

Stars
15.8K
+244 today
Forks
1.4K
Watchers
32
Open issues
7
Open PRs
6
Contributors
~106
Commits
5.1K
Branches
117

TypeScriptAGPL-3.0Created Mar 19, 2026Last push 2d agoLatest release v5.1.4+307 stars this week+963 this month

Quick answers

What is TREK?
A self-hosted travel planner to visually organize trips, track expenses, and manage reservations with AI assistance.
What does TREK do?
TREK is an open-source, self-hosted travel planning application serving as an alternative to commercial services like Wanderlog. It provides a highly visual, drag-and-drop interface for users to build comprehensive day plans, plot routes on interactive maps, and collaborate in real-time with other travelers. Beyond route mapping, the platform tracks shared trip budgets, manages ticket reservations, and stores essential documents in one centralized location. Additionally, it integrates a built-in MCP server that allows AI agents to automatically generate packing lists, plan itineraries, and analyze trip costs based on user prompts.
Who is TREK for?
TREK is designed for frequent travelers, homelab enthusiasts, and friend groups who want a private, comprehensive tool to plan and document their trips. It is ideal for users looking for a feature-rich, self-hosted alternative to proprietary travel planners.
How do I get started with TREK?
docker compose up -d
How popular is TREK on GitHub?
liketrek/TREK has 15,814 stars and 1,352 forks on GitHub, and gained 307 stars in the last 7 days.
What license does TREK use?
liketrek/TREK is released under the AGPL-3.0 license.

Star history

since Jul 29, 2026
05K10K15KJul 2026Sep 2026Oct 2026Nov 2026
15.8K stars as of Nov 19, 2026. Measured daily since Jul 29, 2026; GitHub no longer exposes earlier star timestamps.

Update history

4 recorded
  • Nov 15, 2026New release v5.1.4 (previously v5.1.0).
  • Nov 1, 2026New release v5.1.0 (previously v4.3.3).
  • Nov 1, 2026Description changed from "A self-hosted travel/trip planner with real-time collaboration, interactive maps, PWA support, SSO, budgets, packing lis" to "The most complete open-source travel planner: real-time collaboration, bookings, budgets, packing lists, journals, offli".
  • Oct 4, 2026Previously tracked as mauriceboe/TREK; its 1 daily snapshot and 3 trending appearances were merged into this profile. Stars: 11,124 on 2026-07-29 under the old name, 14,528 on 2026-10-02 (+3,404).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 0 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 0 commits2026-01-28: 0 commits2026-01-29: 0 commits2026-01-30: 0 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 0 commits2026-02-03: 0 commits2026-02-04: 0 commits2026-02-05: 0 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 0 commits2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 0 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 0 commits2026-03-05: 0 commits2026-03-06: 0 commits2026-03-07: 0 commits2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 0 commits2026-03-12: 0 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 0 commits2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 2 commits2026-03-19: 39 commits2026-03-20: 6 commits2026-03-21: 14 commits2026-03-22: 8 commits2026-03-23: 8 commits2026-03-24: 17 commits2026-03-25: 6 commits2026-03-26: 9 commits2026-03-27: 5 commits2026-03-28: 21 commits2026-03-29: 48 commits2026-03-30: 65 commits2026-03-31: 40 commits2026-04-01: 52 commits2026-04-02: 15 commits2026-04-03: 67 commits2026-04-04: 51 commits2026-04-05: 63 commits2026-04-06: 27 commits2026-04-07: 12 commits2026-04-08: 12 commits2026-04-09: 23 commits2026-04-10: 26 commits2026-04-11: 27 commits2026-04-12: 31 commits2026-04-13: 21 commits2026-04-14: 31 commits2026-04-15: 30 commits2026-04-16: 30 commits2026-04-17: 18 commits2026-04-18: 22 commits2026-04-19: 12 commits2026-04-20: 21 commits2026-04-21: 47 commits2026-04-22: 22 commits2026-04-23: 11 commits2026-04-24: 0 commits2026-04-25: 0 commits2026-04-26: 8 commits2026-04-27: 4 commits2026-04-28: 5 commits2026-04-29: 1 commit2026-04-30: 1 commit2026-05-01: 1 commit2026-05-02: 0 commits2026-05-03: 5 commits2026-05-04: 2 commits2026-05-05: 0 commits2026-05-06: 3 commits2026-05-07: 2 commits2026-05-08: 0 commits2026-05-09: 0 commits2026-05-10: 2 commits2026-05-11: 0 commits2026-05-12: 0 commits2026-05-13: 4 commits2026-05-14: 0 commits2026-05-15: 2 commits2026-05-16: 1 commit2026-05-17: 0 commits2026-05-18: 0 commits2026-05-19: 0 commits2026-05-20: 0 commits2026-05-21: 0 commits2026-05-22: 0 commits2026-05-23: 0 commits2026-05-24: 2 commits2026-05-25: 3 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 0 commits2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 0 commits2026-06-01: 0 commits2026-06-02: 0 commits2026-06-03: 0 commits2026-06-04: 0 commits2026-06-05: 0 commits2026-06-06: 0 commits2026-06-07: 0 commits2026-06-08: 0 commits2026-06-09: 0 commits2026-06-10: 0 commits2026-06-11: 0 commits2026-06-12: 0 commits2026-06-13: 0 commits2026-06-14: 0 commits2026-06-15: 0 commits2026-06-16: 2 commits2026-06-17: 0 commits2026-06-18: 2 commits2026-06-19: 11 commits2026-06-20: 5 commits2026-06-21: 4 commits2026-06-22: 7 commits2026-06-23: 2 commits2026-06-24: 1 commit2026-06-25: 4 commits2026-06-26: 9 commits2026-06-27: 22 commits2026-06-28: 0 commits2026-06-29: 0 commits2026-06-30: 0 commits2026-07-01: 2 commits2026-07-02: 0 commits2026-07-03: 0 commits2026-07-04: 2 commits2026-07-05: 2 commits2026-07-06: 3 commits2026-07-07: 0 commits2026-07-08: 0 commits2026-07-09: 0 commits2026-07-10: 0 commits2026-07-11: 3 commits2026-07-12: 0 commits2026-07-13: 0 commits2026-07-14: 0 commits2026-07-15: 0 commits2026-07-16: 1 commit2026-07-17: 1 commit2026-07-18: 7 commits2026-07-19: 3 commits2026-07-20: 5 commits2026-07-21: 10 commits2026-07-22: 0 commits2026-07-23: 13 commits2026-07-24: 20 commits2026-07-25: 46 commits2026-07-26: 37 commits2026-07-27: 34 commits2026-07-28: 8 commits2026-07-29: 54 commits2026-07-30: 3 commits2026-07-31: 2 commits2026-08-01: 16 commits2026-08-02: 11 commits2026-08-03: 15 commits2026-08-04: 4 commits2026-08-05: 3 commits2026-08-06: 6 commits2026-08-07: 22 commits2026-08-08: 23 commits2026-08-09: 43 commits2026-08-10: 59 commits2026-08-11: 38 commits2026-08-12: 16 commits2026-08-13: 10 commits2026-08-14: 12 commits2026-08-15: 12 commits2026-08-16: 9 commits2026-08-17: 14 commits2026-08-18: 25 commits2026-08-19: 1 commit2026-08-20: 14 commits2026-08-21: 11 commits2026-08-22: 5 commits2026-08-23: 30 commits2026-08-24: 1 commit2026-08-25: 41 commits2026-08-26: 2 commits2026-08-27: 17 commits2026-08-28: 73 commits2026-08-29: 35 commits2026-08-30: 5 commits2026-08-31: 2 commits2026-09-01: 29 commits2026-09-02: 30 commits2026-09-03: 15 commits2026-09-04: 52 commits2026-09-05: 24 commits2026-09-06: 39 commits2026-09-07: 24 commits2026-09-08: 18 commits2026-09-09: 22 commits2026-09-10: 6 commits2026-09-11: 20 commits2026-09-12: 48 commits2026-09-13: 50 commits2026-09-14: 14 commits2026-09-15: 6 commits2026-09-16: 18 commits2026-09-17: 24 commits2026-09-18: 6 commits2026-09-19: 29 commits2026-09-20: 24 commits2026-09-21: 31 commits2026-09-22: 37 commits2026-09-23: 41 commits2026-09-24: 23 commits2026-09-25: 27 commits2026-09-26: 10 commits2026-09-27: 7 commits2026-09-28: 15 commits2026-09-29: 14 commits2026-09-30: 3 commits2026-10-01: 53 commits2026-10-02: 2 commits2026-10-03: 11 commits2026-10-04: 4 commits2026-10-05: 6 commits2026-10-06: 11 commits2026-10-07: 44 commits2026-10-08: 283 commits2026-10-09: 142 commits2026-10-10: 100 commits2026-10-11: 13 commits2026-10-12: 101 commits2026-10-13: 3 commits2026-10-14: 50 commits2026-10-15: 17 commits2026-10-16: 16 commits2026-10-17: 15 commits2026-10-18: 54 commits2026-10-19: 42 commits2026-10-20: 160 commits2026-10-21: 54 commits2026-10-22: 66 commits2026-10-23: 96 commits2026-10-24: 185 commits2026-10-25: 46 commits2026-10-26: 23 commits2026-10-27: 14 commits2026-10-28: 17 commits2026-10-29: 76 commits2026-10-30: 59 commits2026-10-31: 12 commits2026-11-01: 35 commits2026-11-02: 13 commits2026-11-03: 15 commits2026-11-04: 13 commits2026-11-05: 46 commits2026-11-06: 74 commits2026-11-07: 74 commits2026-11-08: 70 commits2026-11-09: 41 commits2026-11-10: 30 commits2026-11-11: 20 commits2026-11-12: 29 commits2026-11-13: 0 commits2026-11-14: 0 commits2026-11-15: 0 commits2026-11-16: 0 commits2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
4,846 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Widely adopted

    15,814 stars

  • Very active

    4,846 commits in 52 weeks

  • Community-driven

    ~106 contributors

  • Well documented

    High community health score

  • Continuous integration

    Automated checks passing

  • Repeat trending

    3 trending appearances

What TREK does

TREK is an open-source, self-hosted travel planning application serving as an alternative to commercial services like Wanderlog. It provides a highly visual, drag-and-drop interface for users to build comprehensive day plans, plot routes on interactive maps, and collaborate in real-time with other travelers. Beyond route mapping, the platform tracks shared trip budgets, manages ticket reservations, and stores essential documents in one centralized location. Additionally, it integrates a built-in MCP server that allows AI agents to automatically generate packing lists, plan itineraries, and analyze trip costs based on user prompts.

TREK is designed for frequent travelers, homelab enthusiasts, and friend groups who want a private, comprehensive tool to plan and document their trips. It is ideal for users looking for a feature-rich, self-hosted alternative to proprietary travel planners.

  • Interactive trip mapping: Features a drag-and-drop planner paired with 3D terrain maps to optimize daily travel routes.
  • Expense splitting: Tracks multi-currency trip costs and calculates who owes whom, similar to Splitwise.
  • Real-time collaboration: Utilizes WebSockets to instantly sync itinerary changes, chat messages, and polls across multiple users.
  • Reservation management: Imports and organizes flights, hotels, and tickets from booking confirmation emails or PDFs.
  • AI automation: Exposes a built-in MCP server allowing AI assistants to plan days, build budgets, and create packing lists.

Where teams use it

Group trip coordination

Friend groups use the platform to collaboratively plan itineraries, vote on activities, and split shared expenses equitably.

Offline travel access

Travelers install the PWA on their mobile devices to access maps, tickets, and plans reliably without cellular service.

AI-assisted itinerary generation

Users connect their AI assistants via the MCP server to automatically draft day-by-day travel plans for new destinations.

Homelab travel archiving

Privacy-conscious individuals host the app locally to securely store their travel history, photos, and passport documents.

Getting started: docker compose up -d

README

main branch
TREK

Every part of your trip. One app you own.

TREK has grown from a travel planner into a whole ecosystem for trips: plan together in real time on a live map, build hikes, tours and road trips, keep bookings and shared costs in order, pack, write the journal, lay out the photo book and hand the busy work to the built-in AI. Self-hosted, on the web, on your phone and offline.


Demo   Docker   Sonar Quality Gate   GitHub Actions Workflow Status   Discord   Roadmap   Ko-fi   BMAC   License   Latest Release   Docker Pulls   Stars

PUBLIC SERVICES PROUDLY SPONSORED BY
dataforest cloud


TREK, a tour of the app

What you get

Plan, track, share
See all features

Most of what follows is an addon an admin switches on or off. Lists, Costs, Documents, Collab, Tours, Vacay and Atlas ship on; Journey, Collections, MCP, the AI assistant, AI Parsing, Road trip, Dawarich and AirTrail ship off and are marked below.

🧭 Planning
  • Day plans: drag places, notes and bookings between days with undo, or drop a map marker straight onto a day
  • Maps: Leaflet, Mapbox GL or MapLibre GL (OpenFreeMap, no token) with clustering, photo markers, route lines and a whole-trip route overview
  • Places: search the TREK Places index and OpenStreetMap with no key, or Google Places and Amap with one. Descriptions, hours and photos from Wikipedia, Wikidata and Wikimedia Commons, plus a rating and a custom image per place
  • Explore: nearby places by category for the map view, from the TREK Places index with Overpass as fallback
  • Routes: auto-sort a day (nearest neighbour then 2-opt, locked stops and hotels stay put), a travel mode per leg over OSRM or Valhalla, then open the day in Google Maps or CoMaps and a place in seven navigation apps
  • Public transport: door-to-door itineraries over Transitous, or Google where Transitous has no data
  • Import and export: Google Maps and Naver Maps lists, Google Maps directions links, GPX, KML and KMZ in; GPX and an ICS feed per trip or across all trips out
  • Weather: 16-day forecast from Open-Meteo, no key, and the archive for dates beyond it
  • Trip dates: move a trip and its days re-date themselves, with the bookings along or re-anchored. Trips also copy and archive
  • Road trip (off by default): drives with stops, day windows and arrival times that recompute, route alternatives, hazards and EV charging with range
🥾 Tours
  • Seven tour types: hike, city walk, run, bike (touring, road, gravel, MTB), paddle (kayak, canoe, SUP), horse ride, and ski and winter (alpine, cross-country, touring, snowshoe, winter hike)
  • Routing: legs routed over Valhalla with shaping points, hand-drawn legs, route variants, round hikes of a wished length and trip places as stops, all with undo
  • Hikes: routed within a maximum SAC grade (T1 to T6), the trail grades along the way, and via ferratas on the map
  • Terrain: elevation profile, ascent and descent, and a 3D terrain map with grade colouring and a flyover, no token needed. Topo, hiking, cycling and satellite bases with sea marks and ski pistes as overlays
  • Multi-day tours: one route cut into stages and spread across the trip's days
  • Along the way: viewpoints, huts, water, food and more within a corridor of the route, inserted as a stop with the detour it adds
  • Ski, paddle and city walks: a piste router by difficulty and lift type; a water router with portages, locks and a wind forecast; city walks with stays, opening hours and transit between stops
  • Plan against reality: link a recorded GPX to a planned day and compare distance, ascent and time. Import trails from a wanderer instance, save tours to a collection and take them into another trip
🧳 Bookings and money
  • Reservations: 18 booking types with status, confirmation code, travellers and attached files
  • Flights and trains: several legs with stopovers and endpoint timezones, against 4,045 bundled airports so local times resolve without a key
  • Accommodation: a stay spans a range of nights with a check-in window
  • Booking import: EML, PDF, PKPass, HTML, TXT and photos of confirmations, through KItinerary or an AI model, with a review step before anything is saved. Prices become linked costs
  • AirTrail (off by default): import flights from a self-hosted AirTrail instance and keep them in sync
  • Costs: split in integer cents with equal or custom shares, several payers, settle-up suggestions, a per-person summary, a settlement log and CSV export. A receipt photo can fill in an expense
  • Currencies: one per expense with the rate frozen at entry, from Frankfurter with no key
  • Packing lists and to-dos: categories, templates, assignees and visibility tiers; bags with weights as an admin switch; to-dos with due dates, priorities and reminders
  • Files: attach to a trip, place, day or booking, 50 MB each and 500 MB for video, with trash and restore
  • PDF export: cover, place photos, day notes, bookings and costs, with an optional page break per day
👥 Collaboration
  • Real-time sync (WebSocket): edits land live for everyone who has the trip open
  • Members: add by email or username, hand over ownership, or add guests who have no login at all
  • Permissions: an admin maps each of 17 trip actions to admin, trip owner, trip member or everybody
  • Invites: one reusable link per trip with an optional expiry, and admin signup invites that drop a new account straight into a trip
  • Public share: a read-only trip page without an account, with switches for map, bookings, packing, costs and chat
  • Collab: group chat with replies, reactions and link previews, shared notes, links, polls and a What's Next list, each one its own switch
  • Notifications: an inbox grouped by day with answers right from the notification, and a per-user matrix of events against in-app, email, webhook, ntfy, Web Push and plugin channels
📔 Journey and TREK Studio
  • Journey (off by default): dated entries with story, mood, weather and tags, photos and video from uploads, Immich or Synology Photos, map views, co-authors, drafts and a public share link
  • Linked journal: a trip can show one journal as its own, with the members picked on the trip as viewers or editors
  • Recorded days (with Dawarich): keep a day's recorded route and turn its stays into entries
  • TREK Studio: turn a journal into a printable photo book. 34 print-licensed typefaces, 17 themes, 108 designed pages in twelve styles, 160 recolourable stickers, text effects, layers and a Travel tab with route maps, country stamps and trip figures
  • Auto layout: lays the whole book on the designed pages in the style of its theme, every photo in a frame, or rebuilds one spread
  • Print and share: PDF export as pages or spreads with crop marks, several people editing at once, and design files to move a spread into another book
🗺️ Atlas, Vacay and Collections
  • Atlas: countries and regions visited on geoBoundaries outlines, a bucket list, travel stats, and a tour activities tab with planned against recorded totals
  • Vacay: leave calendar with half days, public holidays from nagerholidays.com, school holidays for 16 European countries, company holidays, carry-over between years, and joint or read-only sharing
  • Collections (off by default): a place library outside any trip with lists, labels, ratings, a status per place, cover images, GPX and file export, copy into a trip, and sharing by invite
  • Dawarich (off by default): link a Dawarich instance for recorded tracks, suggested stays and countries for the Atlas
🤖 AI assistant and MCP
  • AI assistant (off by default): a chat that plans with you in a trip, across all your trips, in a journal and in Studio, and works with tours, costs, bookings, packing, Vacay and the Atlas
  • Your own model: an API key for Anthropic, OpenAI, Gemini or OpenRouter, a ChatGPT plan, or any OpenAI-compatible endpoint, set for the instance or per user
  • You stay in charge: reads run at once, every change waits as a card to apply or discard and can be undone for 15 minutes. Nothing leaves before you agree to the provider, and a file's text only with your consent
  • Attachments: drop a booking confirmation, a GPX file or a photo into the chat, and the assistant offers what to do with it
  • MCP server (off by default): OAuth 2.1 with mandatory PKCE and dynamic client registration, 410 tools, 30 resources and 4 prompts, 35 scopes in 17 groups ticked on the consent screen, and every call in the audit log
  • Addon-aware: twelve addon gates decide which tools a session sees, and flipping one re-registers live sessions
🧩 Plugins
  • Third-party plugins: install from the TREK registry or sideload a zip, with their own pages under /plugins/<id>
  • Sandboxed: one child process per plugin, 66 grantable permissions, an admin-edited outbound host allowlist, memory and call caps
  • Trust: registry downloads are pinned by sha256 and checked against the author's minisign key, a sideloaded zip is marked unverified, and TREK_PLUGINS_ENABLED=false turns the whole system off
  • Extension points: map layers, place details, day schedules, PDF sections, Atlas layers, journal rows, trip warnings, search and photo providers, route profiles, notification channels and MCP tools
  • SDK: trek-plugin-sdk with a CLI to create, validate, run against real data, sign and publish
📱 Mobile and offline
  • Apps: TREK Travel Planner for iPhone, iPad and Android connects to any TREK server, and the browser installs TREK as a standalone app with a themed status bar too
  • Phone layouts: their own screens for every part of the app, with a bottom bar and dashboard widgets the user orders
  • Offline reads: the app shell is precached and trips, places, tours, files and nearby places live in a per-user IndexedDB store, so a trip opens with no network
  • Offline writes: changes queue and replay with an X-Idempotency-Key, and a stale edit waits for a keep-mine or keep-theirs choice
  • Offline maps: raster and vector tiles of a trip downloaded ahead, and a switch that takes the whole app offline on purpose
⚙️ Admin, accounts and security
  • Sign-in: password, OIDC and passkeys each switch on and off on their own, OIDC_ONLY leaves SSO as the only way in, and an OIDC claim can grant admin
  • SSO and 2FA: one OIDC provider by discovery with PKCE (Authentik, Keycloak, Google and the like), TOTP with backup codes that an admin can require, and passkeys that count as the second factor
  • Sessions: every sign-in is a session you can see and end, one by one or all others at once
  • Hardening: rate limits on sign-in, reset and 2FA, a password policy, secrets encrypted at rest and masked on read, and an SSRF guard on every URL you configure
  • Admin panel: users and the permission matrix, defaults for new users, categories and templates, addons, plugins, storage, notifications, MCP tokens, backups, audit log and releases
  • Backups and storage: scheduled backups with retention that restore their own secrets, and local or S3-compatible storage per content category with replicas
  • Appearance: light, dark or follow the OS, seven colour schemes plus a custom accent, transparency, density, reduced motion and text size
  • 28 languages: en, de, es, fr, it, nl, hu, ru, zh, zh-TW, pl, cs, ar (right to left), he (right to left), br, id, tr, ja, ko, uk, gr, sv, vi, ca, az, et, sk, th
  • Help center: a ? in the top bar with 381 step-by-step guides with screenshots, searched together with the wiki that ships in the image

Atlas · dashboard · trip planner Mobile PWA · dashboard, day plan, map, costs

Powered by dataforest cloud


dataforest cloud

Every TREK installation in the world searches through servers that dataforest cloud sponsors.

The place index with over 88 million places, the address search in every TREK language and the planet-wide routing all run on dataforest cloud in Frankfurt, Germany, free of charge for everyone who self-hosts TREK. Without this sponsorship, these services would not exist in this form.

Thank you, dataforest, for backing open source this generously. 💚


Visit dataforest cloud

Looking for a server for your own TREK? dataforest cloud is where TREK's own services live.


AI usage

We use LLM-assisted coding tools across parts of this codebase. Nothing ships that a maintainer has not read and understood: every change goes through a pull request, is reviewed and tested, and has a human who can answer for it. "The AI wrote that" is not an answer any of us would accept from ourselves.

See How we use AI in TREK for the details.


Get started in 30 seconds

ENCRYPTION_KEY=$(openssl rand -hex 32) docker run -d --name trek -p 3000:3000 \
  -e ENCRYPTION_KEY=$ENCRYPTION_KEY \
  -e COOKIE_SECURE=false \
  -v ./data:/app/data -v ./uploads:/app/uploads mauriceboe/trek

Open http://localhost:3000, or http://<server-ip>:3000 from another machine. On first boot TREK seeds an admin account — if you set ADMIN_EMAIL/ADMIN_PASSWORD those are used, otherwise the credentials are printed to the container log (docker logs trek).

COOKIE_SECURE=false is only for trying TREK over plain HTTP: without it the browser drops the session cookie and the login does not stick. Once TREK sits behind HTTPS (see Reverse Proxy), remove it.

TrueNAS SCALE: Install TREK directly from the Community catalog. See the TrueNAS SCALE installation guide.

Tip

No server yet? TREK's own public services run on dataforest cloud, our infrastructure sponsor. A small seed is plenty for a TREK instance and is ready within a minute.


Tech stack

Node.js NestJS SQLite React Vite TypeScript Tailwind Leaflet Docker

Real-time sync via WebSocket (ws). Backend on NestJS 11. State with Zustand. Auth via JWT + OAuth 2.1 + OIDC + Passkeys (WebAuthn) + TOTP MFA. Weather via Open-Meteo (no key required). Maps with Leaflet and Mapbox GL.


Docker Compose (production)

The repository ships a ready-to-use docker-compose.yml with secure defaults and every option documented inline. Download it, then:

docker compose up -d

See Install with Docker Compose for the full walkthrough.


Helm (Kubernetes)

helm repo add trek https://chart.liketrek.com
helm repo update
helm install trek trek/trek

See charts/README.md for values.


Install as App (PWA)

TREK works as a Progressive Web App, and the TREK Travel Planner app for iPhone, iPad and Android connects to the same server (Native Apps). To install the web app instead:

  1. Open TREK in the browser (HTTPS required)
  2. iOS: Share ▸ Add to Home Screen
  3. Android: Menu ▸ Install app (or Add to Home Screen)

TREK then launches fullscreen with its own icon, just like a native app.


Updating

See Updating — Docker Compose, Docker run, Helm, Portainer, Unraid, TrueNAS SCALE and Proxmox, plus the encryption-key note.


Reverse Proxy

For production, put TREK behind a TLS-terminating reverse proxy. TREK uses WebSockets for real-time sync, so the proxy must support WebSocket upgrades on /ws.

If you use the MCP addon, the proxy must also pass the Mcp-Session-Id header through in both directions on /mcp — Nginx and Caddy do this by default, but a proxy that strips it makes every tool call open a new session instead of reusing one. See the Reverse Proxy wiki page for details.

Nginx
server {
    listen 80;
    server_name trek.yourdomain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name trek.yourdomain.com;

    ssl_certificate     /etc/ssl/fullchain.pem;
    ssl_certificate_key /etc/ssl/privkey.pem;

    # 500 MB covers backup-restore uploads (capped at 500 MB server-side).
    client_max_body_size 500m;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /ws {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 86400;
    }

    # Only needed if you use the MCP addon. Responses are Server-Sent Events,
    # so buffering must be off or tool results arrive late.
    location /mcp {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
        proxy_read_timeout 3600s;
    }
}
Caddy
trek.yourdomain.com {
    reverse_proxy localhost:3000
}

Caddy handles TLS and WebSockets automatically.


Environment variables

Every variable, its default and what it does: see Environment Variables.

Data sources

The Atlas map's country and sub-national (province/county) boundaries come from geoBoundaries (Runfola et al., 2020), licensed CC BY 4.0; Ireland's counties come from Tailte Éireann, also CC BY 4.0. See NOTICE.md for full third-party attributions.


License

TREK is AGPL v3. Self-host freely for personal or internal company use. If you modify and offer TREK as a network service to third parties, your modifications must be open-sourced under the same licence.

View on GitHub

Recent activity

commits and pull requests

Recent open issues

view all

Discussions

all 781

Releases and announcements

104 total
  1. v5.1.4v5.1.4Nov 12, 2026

    ## 5.1.4 [Full diff since 5.1.3](https://github.com/liketrek/TREK/compare/v5.1.3...v5.1.4) This release keeps Vacay's public holidays working past January 2027, when the old holiday API ends, and fixes AirTrail sending its stored API key to a newly entered address. Update before February; the apps for iPhone, iPad, Apple Watch and Android are still in a closed test, and you can join: 👉 **[Sign up at liketrek.com/app-test](https://liketrek.com/app-test)**. ### Added - Bakeries and groceries on the map and along a hike ([#3026](https://github.com/liketrek/TREK/issues/3026)). The map's place search and a tour's stops along the route also find bakeries and supermarkets, for restocking on a multi-day hike. - Settings say what they reach. On a phone and in the app the sections stand under "Your account", which follows you to every device, and "This device". - An install guide for TrueNAS SCALE in the wiki ([#3060](https://github.com/liketrek/TREK/issues/3060)), from the TrueNAS Community catalog, including updates. ### Fixed **Security** - AirTrail kept its API key for a new address. Saving the settings with another host and the key field left as it was kept the stored key, and t

  2. v5.1.3v5.1.3Nov 10, 2026

    ## 5.1.3 [Full diff since 5.1.2](https://github.com/liketrek/TREK/compare/v5.1.2...v5.1.3) This release fixes the SSO sign-in of the TREK apps, which kept many testers of the closed app test from signing in at all. If you run TREK with SSO and test the app, please update your server; the app itself needs no update for it. The next app build will ask for TREK 5.1.3 on the server, so it is worth updating now. The apps for iPhone, iPad, Apple Watch and Android are still in a closed test, and you can join. 👉 **[Sign up at liketrek.com/app-test](https://liketrek.com/app-test)** and connect the app to a TREK server on the newest version, such as this one, or to the demo; please don't test with TREK Cloud. ### Fixed **Sign-in** - Signing in to the app with SSO or a passkey still ended in the web app for many. A browser that had run TREK before 5.1.1 keeps that version in its service worker, and the worker answered the app's handoff page from its cache with a version that has no such page, so the sign-in ended on the dashboard in the browser instead of in the app. The app now starts its sign-in on a page the server always answers itself; it takes the old worker off the browser, and

  3. v5.1.2v5.1.2Nov 9, 2026

    ## 5.1.2 [Full diff since 5.1.1](https://github.com/liketrek/TREK/compare/v5.1.1...v5.1.2) ### Test the TREK apps **The TREK apps for iPhone, iPad, Apple Watch and Android are in a closed test, and you can join.** They run on your own TREK server and add what a browser cannot: home and lock screen widgets, an Apple Watch app, encrypted push notifications, offline maps, sharing from any app into a trip, Wallet passes, and layouts made for iPad, tablets and foldables. 👉 **[Sign up at liketrek.com/app-test](https://liketrek.com/app-test)**: pick Apple or Android, tick the devices you can test on, and leave the email of your Apple ID or Google account. Connect the app to a TREK server on the newest version, such as this one, or to the demo; please don't test with TREK Cloud. ### Fixed **Photos** - Synology Photos: journey photos took the capture date and place of the next photo. On libraries where Synology's item and thumbnail ids match, the metadata came from the neighbouring item; TREK now takes only the item the thumbnail belongs to. Photos attached before this release are asked again once after the update and get their own date and place back. (Closes #3019) **Trips and pa

  4. v5.1.1v5.1.1Nov 8, 2026

    ## 5.1.1 [Full diff since 5.1.0](https://github.com/liketrek/TREK/compare/v5.1.0...v5.1.1) ### Test the TREK apps **The TREK apps for iPhone, iPad, Apple Watch and Android are in a closed test, and you can join.** They run on your own TREK server and add what a browser cannot: home and lock screen widgets, an Apple Watch app, encrypted push notifications, offline maps, sharing from any app into a trip, Wallet passes, and layouts made for iPad, tablets and foldables. 👉 **[Sign up at liketrek.com/app-test](https://liketrek.com/app-test)**: pick Apple or Android, tick the devices you can test on, and leave the email of your Apple ID or Google account. Access goes out once the builds pass Apple's and Google's review. Connect the app to a TREK server on the newest version, such as this one, or to the demo; please don't test with TREK Cloud. ### Fixed **Assistant** - The assistant on Claude Sonnet 5.5 came back without an answer. The model at times ended a turn on its follow-up suggestions alone; it is now asked for the answer, and the suggestions show under it. (#2930, Closes #2789) - A chat failed with HTTP 400 after leaving the page. Leaving while the assistant

  5. v5.1.0v5.1.0Oct 31, 2026

    ## 5.1.0 [Full diff since 5.0.1](https://github.com/liketrek/TREK/compare/v5.0.1...v5.1.0) ### Highlights **TREK now runs its own map services, on servers sponsored by [dataforest cloud](https://cloud.dataforest.net/en?mtm_campaign=trek).** Place search, address search and routing come from TREK's own servers instead of public services that limit, slow down or drop requests. Every installation is connected on its own, without any setup. A big thank you to [dataforest](https://cloud.dataforest.net/en?mtm_campaign=trek), who make all of this possible for every TREK installation: cloud servers made in Germany, in Frankfurt, billed by the hour. - **Routes that match the road.** Every day, road trip and assistant route is calculated by TREK's own planet-wide Valhalla with elevation data. It knows road classes, turns, tolls, ferries and climbs, so routes and driving times come far closer to what you will actually drive. - **The right place first.** Search now finds the place you mean far more often, and answers three times faster. - **Place details in milliseconds**, from TREK's own copy of OpenStreetMap instead of the public Overpass servers. - **Place details from the wh

Code frequency

additions and deletions
+750.4K-750.4KWeek of 2026-03-15: +40,772 linesWeek of 2026-03-15: -2,844 linesWeek of 2026-03-22: +52,511 linesWeek of 2026-03-22: -39,557 linesWeek of 2026-03-29: +98,580 linesWeek of 2026-03-29: -38,319 linesWeek of 2026-04-05: +147,322 linesWeek of 2026-04-05: -53,605 linesWeek of 2026-04-12: +60,818 linesWeek of 2026-04-12: -8,829 linesWeek of 2026-04-19: +17,585 linesWeek of 2026-04-19: -2,389 linesWeek of 2026-04-26: +3,537 linesWeek of 2026-04-26: -857 linesWeek of 2026-05-03: +3,018 linesWeek of 2026-05-03: -3,363 linesWeek of 2026-05-10: +1,157 linesWeek of 2026-05-10: -3,030 linesWeek of 2026-05-17: +0 linesWeek of 2026-05-17: -0 linesWeek of 2026-05-24: +1,170 linesWeek of 2026-05-24: -261 linesWeek of 2026-05-31: +0 linesWeek of 2026-05-31: -0 linesWeek of 2026-06-07: +0 linesWeek of 2026-06-07: -0 linesWeek of 2026-06-14: +167,289 linesWeek of 2026-06-14: -99,378 linesWeek of 2026-06-21: +6,997 linesWeek of 2026-06-21: -884 linesWeek of 2026-06-28: +308 linesWeek of 2026-06-28: -51 linesWeek of 2026-07-05: +98,450 linesWeek of 2026-07-05: -8,041 linesWeek of 2026-07-12: +33,521 linesWeek of 2026-07-12: -4,527 linesWeek of 2026-07-19: +68,515 linesWeek of 2026-07-19: -5,330 linesWeek of 2026-07-26: +181,995 linesWeek of 2026-07-26: -46,265 linesWeek of 2026-08-02: +36,538 linesWeek of 2026-08-02: -30,673 linesWeek of 2026-08-09: +70,798 linesWeek of 2026-08-09: -27,345 linesWeek of 2026-08-16: +80,728 linesWeek of 2026-08-16: -8,488 linesWeek of 2026-08-23: +479,817 linesWeek of 2026-08-23: -90,257 linesWeek of 2026-08-30: +42,222 linesWeek of 2026-08-30: -6,501 linesWeek of 2026-09-06: +75,998 linesWeek of 2026-09-06: -11,395 linesWeek of 2026-09-13: +88,882 linesWeek of 2026-09-13: -9,995 linesWeek of 2026-09-20: +248,572 linesWeek of 2026-09-20: -19,407 linesWeek of 2026-09-27: +79,477 linesWeek of 2026-09-27: -40,108 linesWeek of 2026-10-04: +420,781 linesWeek of 2026-10-04: -174,642 linesWeek of 2026-10-11: +103,448 linesWeek of 2026-10-11: -14,433 linesWeek of 2026-10-18: +750,380 linesWeek of 2026-10-18: -123,486 linesWeek of 2026-10-25: +58,848 linesWeek of 2026-10-25: -9,354 linesWeek of 2026-11-01: +91,225 linesWeek of 2026-11-01: -18,262 linesWeek of 2026-11-08: +29,348 linesWeek of 2026-11-08: -9,167 linesWeek of 2026-11-15: +0 linesWeek of 2026-11-15: -0 linesMar 15, 2026Nov 15, 2026
+3.6M lines added, -911K removed over the last year.

Commits per week

last 52 weeks
6570Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 0 commitsWeek of 2026-01-25: 0 commitsWeek of 2026-02-01: 0 commitsWeek of 2026-02-08: 0 commitsWeek of 2026-02-15: 0 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 0 commitsWeek of 2026-03-08: 0 commitsWeek of 2026-03-15: 61 commitsWeek of 2026-03-22: 74 commitsWeek of 2026-03-29: 338 commitsWeek of 2026-04-05: 190 commitsWeek of 2026-04-12: 183 commitsWeek of 2026-04-19: 113 commitsWeek of 2026-04-26: 20 commitsWeek of 2026-05-03: 12 commitsWeek of 2026-05-10: 9 commitsWeek of 2026-05-17: 0 commitsWeek of 2026-05-24: 5 commitsWeek of 2026-05-31: 0 commitsWeek of 2026-06-07: 0 commitsWeek of 2026-06-14: 20 commitsWeek of 2026-06-21: 49 commitsWeek of 2026-06-28: 4 commitsWeek of 2026-07-05: 8 commitsWeek of 2026-07-12: 9 commitsWeek of 2026-07-19: 97 commitsWeek of 2026-07-26: 154 commitsWeek of 2026-08-02: 84 commitsWeek of 2026-08-09: 190 commitsWeek of 2026-08-16: 79 commitsWeek of 2026-08-23: 199 commitsWeek of 2026-08-30: 157 commitsWeek of 2026-09-06: 177 commitsWeek of 2026-09-13: 147 commitsWeek of 2026-09-20: 193 commitsWeek of 2026-09-27: 105 commitsWeek of 2026-10-04: 590 commitsWeek of 2026-10-11: 215 commitsWeek of 2026-10-18: 657 commitsWeek of 2026-10-25: 247 commitsWeek of 2026-11-01: 270 commitsWeek of 2026-11-08: 190 commitsWeek of 2026-11-15: 0 commitsNov 23, 2025Nov 15, 2026
4.8K commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 31 commitsSun 1:00 — 25 commitsSun 2:00 — 19 commitsSun 3:00 — 13 commitsSun 4:00 — 3 commitsSun 5:00 — 3 commitsSun 6:00 — 1 commitsSun 7:00 — 1 commitsSun 8:00 — 0 commitsSun 9:00 — 13 commitsSun 10:00 — 37 commitsSun 11:00 — 40 commitsSun 12:00 — 40 commitsSun 13:00 — 40 commitsSun 14:00 — 52 commitsSun 15:00 — 40 commitsSun 16:00 — 37 commitsSun 17:00 — 37 commitsSun 18:00 — 37 commitsSun 19:00 — 28 commitsSun 20:00 — 28 commitsSun 21:00 — 36 commitsSun 22:00 — 50 commitsSun 23:00 — 55 commitsMon 0:00 — 27 commitsMon 1:00 — 4 commitsMon 2:00 — 2 commitsMon 3:00 — 2 commitsMon 4:00 — 1 commitsMon 5:00 — 2 commitsMon 6:00 — 1 commitsMon 7:00 — 4 commitsMon 8:00 — 6 commitsMon 9:00 — 25 commitsMon 10:00 — 37 commitsMon 11:00 — 32 commitsMon 12:00 — 43 commitsMon 13:00 — 28 commitsMon 14:00 — 31 commitsMon 15:00 — 20 commitsMon 16:00 — 19 commitsMon 17:00 — 39 commitsMon 18:00 — 23 commitsMon 19:00 — 37 commitsMon 20:00 — 46 commitsMon 21:00 — 69 commitsMon 22:00 — 54 commitsMon 23:00 — 51 commitsTue 0:00 — 17 commitsTue 1:00 — 6 commitsTue 2:00 — 4 commitsTue 3:00 — 3 commitsTue 4:00 — 2 commitsTue 5:00 — 10 commitsTue 6:00 — 4 commitsTue 7:00 — 1 commitsTue 8:00 — 9 commitsTue 9:00 — 27 commitsTue 10:00 — 17 commitsTue 11:00 — 11 commitsTue 12:00 — 32 commitsTue 13:00 — 31 commitsTue 14:00 — 32 commitsTue 15:00 — 46 commitsTue 16:00 — 39 commitsTue 17:00 — 27 commitsTue 18:00 — 24 commitsTue 19:00 — 28 commitsTue 20:00 — 64 commitsTue 21:00 — 70 commitsTue 22:00 — 75 commitsTue 23:00 — 40 commitsWed 0:00 — 17 commitsWed 1:00 — 3 commitsWed 2:00 — 2 commitsWed 3:00 — 3 commitsWed 4:00 — 9 commitsWed 5:00 — 6 commitsWed 6:00 — 5 commitsWed 7:00 — 4 commitsWed 8:00 — 9 commitsWed 9:00 — 27 commitsWed 10:00 — 33 commitsWed 11:00 — 16 commitsWed 12:00 — 27 commitsWed 13:00 — 26 commitsWed 14:00 — 31 commitsWed 15:00 — 26 commitsWed 16:00 — 44 commitsWed 17:00 — 32 commitsWed 18:00 — 22 commitsWed 19:00 — 41 commitsWed 20:00 — 38 commitsWed 21:00 — 44 commitsWed 22:00 — 37 commitsWed 23:00 — 21 commitsThu 0:00 — 27 commitsThu 1:00 — 14 commitsThu 2:00 — 5 commitsThu 3:00 — 2 commitsThu 4:00 — 3 commitsThu 5:00 — 0 commitsThu 6:00 — 0 commitsThu 7:00 — 3 commitsThu 8:00 — 14 commitsThu 9:00 — 27 commitsThu 10:00 — 23 commitsThu 11:00 — 56 commitsThu 12:00 — 77 commitsThu 13:00 — 67 commitsThu 14:00 — 42 commitsThu 15:00 — 116 commitsThu 16:00 — 78 commitsThu 17:00 — 87 commitsThu 18:00 — 35 commitsThu 19:00 — 23 commitsThu 20:00 — 27 commitsThu 21:00 — 47 commitsThu 22:00 — 35 commitsThu 23:00 — 31 commitsFri 0:00 — 9 commitsFri 1:00 — 12 commitsFri 2:00 — 15 commitsFri 3:00 — 14 commitsFri 4:00 — 4 commitsFri 5:00 — 8 commitsFri 6:00 — 5 commitsFri 7:00 — 5 commitsFri 8:00 — 2 commitsFri 9:00 — 10 commitsFri 10:00 — 63 commitsFri 11:00 — 32 commitsFri 12:00 — 50 commitsFri 13:00 — 70 commitsFri 14:00 — 45 commitsFri 15:00 — 49 commitsFri 16:00 — 43 commitsFri 17:00 — 62 commitsFri 18:00 — 27 commitsFri 19:00 — 57 commitsFri 20:00 — 42 commitsFri 21:00 — 41 commitsFri 22:00 — 56 commitsFri 23:00 — 60 commitsSat 0:00 — 39 commitsSat 1:00 — 23 commitsSat 2:00 — 11 commitsSat 3:00 — 2 commitsSat 4:00 — 4 commitsSat 5:00 — 2 commitsSat 6:00 — 5 commitsSat 7:00 — 0 commitsSat 8:00 — 10 commitsSat 9:00 — 21 commitsSat 10:00 — 18 commitsSat 11:00 — 61 commitsSat 12:00 — 73 commitsSat 13:00 — 57 commitsSat 14:00 — 47 commitsSat 15:00 — 51 commitsSat 16:00 — 46 commitsSat 17:00 — 38 commitsSat 18:00 — 35 commitsSat 19:00 — 44 commitsSat 20:00 — 29 commitsSat 21:00 — 43 commitsSat 22:00 — 57 commitsSat 23:00 — 107 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
Jul 10, 2026daily#23+2
Jun 26, 2026daily#6+24
Mar 29, 2026daily#17+201
  • public-apis/public-apis

    A collective list of free APIs

    500.5K stars · Python

  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    471.6K stars · TypeScript

  • freeCodeCamp/freeCodeCamp

    freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free.

    459.4K stars · TypeScript

  • openclaw/openclaw

    The AI that really does things. Any OS. Any Platform. The lobster way. 🦞

    394.9K stars · TypeScript

  • awesome-selfhosted/awesome-selfhosted

    A list of Free Software network services and web applications which can be hosted on your own servers

    339K stars

  • anomalyco/opencode

    The open source coding agent.

    228.3K stars · TypeScript