# TREK | Maurice | Knowledge Base | Instagit

A self-hosted travel/trip planner with real-time collaboration, interactive maps, PWA support, SSO, budgets, packing lists, and more.

GitHub Stars: 7.4k

Repository: https://github.com/mauriceboe/TREK

---

## Articles

### [How to Configure Multi-Currency Support and Exchange Rates in TREK Trip Budgets](/mauriceboe/TREK/how-to-configure-multi-currency-support-and-exchange-rates-in-trek-trip-budgets)

Easily configure multi-currency trip budgets in TREK using ISO-4217 codes. Learn how TREK automatically converts amounts with live exchange rates from the Frankfurter API.

- Tags: how-to-guide
- Published: 2026-07-11

### [How to Use TREK's Booking Import Feature with KDE Itinerary for PDF and Email Extraction](/mauriceboe/TREK/how-to-use-treks-booking-import-feature-with-kde-itinerary-for-pdf-email-extraction)

Learn how to use TREK's booking import feature with KDE Itinerary. Effortlessly extract travel details from PDFs and emails into structured reservations. Streamline your travel planning today.

- Tags: how-to-guide
- Published: 2026-07-11

### [How to Manage Packing Lists with Bags, Categories, and Member Assignments in TREK](/mauriceboe/TREK/how-to-manage-packing-lists-with-bags-categories-and-member-assignments-in-trek)

Master packing lists in TREK using bags categories and member assignments. Learn how this three-tier system simplifies item organization and tracking for your trips.

- Tags: how-to-guide
- Published: 2026-07-11

### [How TREK's Budget Addon Handles Expense Splitting and Settlement](/mauriceboe/TREK/how-does-the-expense-splitting-and-settlement-system-work-in-treks-budget-addon)

Discover how TREK's Budget addon simplifies expense splitting and settlement. Learn about its automated payment calculation and debt balancing system for efficient trip financial management.

- Tags: deep-dive
- Published: 2026-07-11

### [How to Set Up Email and Webhook Notifications in TREK Using SMTP](/mauriceboe/TREK/how-to-set-up-email-and-webhook-notifications-in-trek-using-smtp)

Learn to set up email and webhook notifications in TREK using SMTP. Configure credentials via the Admin UI for seamless alerts and integrate with nodemailer and HTTP POST.

- Tags: how-to-guide
- Published: 2026-07-11

### [How TREK's Weather Forecast Integration with Open-Meteo API Works](/mauriceboe/TREK/how-does-treks-weather-forecast-integration-with-open-meteo-api-work)

Learn how TREK integrates weather forecasts using the Open-Meteo API. Discover coordinate validation, caching, and WMO code translation for accurate weather data.

- Tags: how-to-guide
- Published: 2026-07-11

### [How to Configure Database Schema Migrations in TREK and What Happens During Updates](/mauriceboe/TREK/how-to-configure-database-schema-migrations-in-trek-and-what-happens-during-updates)

Learn how to configure database schema migrations in TREK. TREK automates SQLite schema evolution on server startup, ensuring idempotent updates with error handling.

- Tags: how-to-guide
- Published: 2026-07-11

### [TREK Plugin Runtime Architecture and Host RPC Communication: A Deep Dive](/mauriceboe/TREK/what-is-treks-plugin-runtime-architecture-and-how-does-host-rpc-communication-function)

Explore TREK's plugin runtime architecture and host RPC communication. Learn how plugins run in isolated Node.js processes for secure, permission-gated host interaction.

- Tags: deep-dive
- Published: 2026-07-11

### [How Session Management Works in TREK: 'Remember Me' and Session Duration](/mauriceboe/TREK/how-does-session-management-work-in-trek-with-remember-me-and-session-duration)

Discover TREK session management. Learn how JWT cookies, 'Remember me', and session duration work using environment variables like SESSION_DURATION.

- Tags: internals
- Published: 2026-07-11

### [How TREK Handles Encryption at Rest and ENCRYPTION_KEY Rotation](/mauriceboe/TREK/how-does-trek-handle-encryption-at-rest-and-how-to-rotate-the-encryption-key)

Discover how TREK secures sensitive data with AES-256-GCM encryption at rest and learn about seamless ENCRYPTION_KEY rotation via migration scripts with no service interruption.

- Tags: how-to-guide
- Published: 2026-07-11

### [How to Set Up a Reverse Proxy with WebSocket Support for TREK Production Deployments](/mauriceboe/TREK/how-to-set-up-a-reverse-proxy-nginx-caddy-with-websocket-support-for-trek-production-deployments)

Set up TREK with a reverse proxy and WebSocket support for production. Learn to configure Nginx or Caddy for secure, scalable deployments including WebSocket upgrades and large body limits.

- Tags: how-to-guide
- Published: 2026-07-11

### [How to Create Custom Plugins Using the TREK Plugin SDK: Permissions and Development Guide](/mauriceboe/TREK/how-can-i-create-custom-plugins-using-the-trek-plugin-sdk-and-what-is-the-permissions-model)

Learn to create custom plugins with the TREK plugin SDK. Understand the strict permission model for building secure, isolated Node.js plugins.

- Tags: how-to-guide
- Published: 2026-07-11

### [How to Configure OIDC/SSO Authentication with Authentik, Keycloak, Google, or Apple in TREK](/mauriceboe/TREK/how-to-configure-oidc-sso-authentication-with-authentik-keycloak-google-or-apple-in-trek)

Configure OIDC SSO authentication for TREK using Authentik, Keycloak, Google, or Apple. Learn how to set up seamless single sign-on with this flexible OIDC flow.

- Tags: how-to-guide
- Published: 2026-07-11

### [How TREK Uses WebSockets for Real-Time Collaboration and Room-Based Trip Channels](/mauriceboe/TREK/how-does-trek-use-websockets-for-real-time-collaboration-and-room-based-trip-channels)

Discover how TREK leverages WebSockets for real-time collaboration and room-based trip channels. Learn about authentication, room grouping, and state recovery for seamless user experiences.

- Tags: internals
- Published: 2026-07-11

### [TREK Community Forums and Support Channels: Where to Get Help](/mauriceboe/TREK/what-are-the-trek-community-forums-or-support-channels)

Find TREK community forums and support channels. Get help via Discord, GitHub Issues, and the public Kanban roadmap for real-time chat and project visibility.

- Tags: getting-started
- Published: 2026-07-10

### [How to Monitor TREK Performance Using the Health Endpoint API](/mauriceboe/TREK/how-to-monitor-trek-performance)

Easily monitor TREK performance with the health endpoint API. Integrate with Prometheus, Grafana, or uptime tools for seamless runtime metadata insights. Learn more now.

- Tags: how-to-guide
- Published: 2026-07-10

### [TREK Deployment Options: Complete Guide to Docker, Kubernetes, and Self-Hosted Install](/mauriceboe/TREK/what-are-the-trek-deployment-options)

Explore TREK deployment options: Docker, Kubernetes Helm charts, and self-hosted installs. This guide covers Unraid, Portainer, Proxmox, and more for easy setup.

- Tags: how-to-guide
- Published: 2026-07-10

### [How to Update TREK to the Latest Version: Complete Docker Guide](/mauriceboe/TREK/how-to-update-trek-to-the-latest-version)

Easily update TREK to the latest version. This Docker guide shows you how to pull the newest image and recreate containers, preserving all your data for a seamless upgrade.

- Tags: how-to-guide
- Published: 2026-07-10

### [Licensing Details for TREK: AGPL-3.0 and MIT Explained](/mauriceboe/TREK/what-are-the-licensing-details-for-trek)

Understand the TREK licensing: AGPL-3.0 for the main repository and MIT for the plugin-sdk submodule. Learn the details of each license.

- Tags: licensing-details
- Published: 2026-07-10

### [Complete Guide to TREK API Endpoints: NestJS REST API Reference](/mauriceboe/TREK/what-are-the-trek-api-endpoints)

Explore TREK API endpoints in this complete guide to the NestJS REST API reference. Discover routes for trips, reservations, weather, and more under api.*.

- Tags: api-reference
- Published: 2026-07-10

### [How to Set Up a TREK CI/CD Pipeline: Complete Guide for the Travel-Ready Enterprise Kit](/mauriceboe/TREK/how-to-set-up-a-trek-ci-cd-pipeline)

Learn to set up a TREK CI/CD pipeline automating linting, type-checking, testing, and Docker builds. Deploy easily with docker-compose or Helm charts.

- Tags: how-to-guide
- Published: 2026-07-10

### [How to Integrate TREK with Other Systems: REST API, WebSocket, Plugins, and MCP](/mauriceboe/TREK/how-to-integrate-trek-with-other-systems)

Learn how to integrate TREK with other systems using its REST API, WebSocket, plugins, and MCP. This guide covers key integration mechanisms for seamless connectivity.

- Tags: how-to-guide
- Published: 2026-07-10

### [How to Debug TREK Code: Essential Strategies for the Travel Planner Stack](/mauriceboe/TREK/how-to-debug-trek-code)

Learn to debug TREK code effectively. Explore strategies for full-stack debugging, Node debugger attachment, WebSocket inspection, and environment variable verification to pinpoint and resolve issues.

- Tags: how-to-guide
- Published: 2026-07-10

### [Main TREK Source Files: Complete Backend and Frontend Architecture Guide](/mauriceboe/TREK/what-are-the-main-trek-source-files)

Explore the main TREK source files, including the Node.js backend and React frontend architecture along with database and state management details. Understand the complete TREK project structure.

- Tags: architecture
- Published: 2026-07-10

### [How to Configure TREK Settings: UI and API Methods Explained](/mauriceboe/TREK/how-to-configure-trek-settings)

Learn to configure TREK settings using the user interface or REST API. Maurice Boe's TREK repository offers detailed UI and API methods for seamless configuration.

- Tags: how-to-guide
- Published: 2026-07-10

### [What Is the TREK Shared Directory Used For? A Complete Guide to @trek/shared](/mauriceboe/TREK/what-is-the-trek-shared-directory-used-for)

Discover what the TREK shared directory is for. Learn how @trek/shared centralizes API contracts, Zod schemas, and i18n strings for your NestJS and React applications.

- Tags: deep-dive
- Published: 2026-07-10

### [How to Build TREK from Source: Complete Local and Docker Installation Guide](/mauriceboe/TREK/how-to-build-trek-from-source)

Learn how to build TREK from source with our easy local and Docker installation guide. Clone the repo, run the build script, and start the server fast.

- Tags: how-to-guide
- Published: 2026-07-10

### [How to Test Changes in TREK: A Complete Guide to Unit, Integration, and E2E Testing](/mauriceboe/TREK/how-to-test-changes-in-trek)

Test TREK changes effectively. Learn to run the full test suite or target specific workspaces and files using npm scripts and Vitest filters for efficient development.

- Tags: how-to-guide
- Published: 2026-07-10

### [What Programming Languages Does TREK Use? A Full-Stack TypeScript Breakdown](/mauriceboe/TREK/what-programming-languages-does-trek-use)

Discover what programming languages TREK uses. This full-stack TypeScript breakdown covers React 19 front-end with TSX and a Node.js back-end with NestJS.

- Tags: deep-dive
- Published: 2026-07-10

### [Core Components of TREK: Architecture of a Self-Hosted Travel Planning Platform](/mauriceboe/TREK/what-are-the-core-components-of-trek)

Explore the core components of TREK, a self-hosted travel planning platform. Discover its architecture, including React, Node.js, PostgreSQL, and real-time collaboration features.

- Tags: architecture
- Published: 2026-07-10

### [How to Set Up the TREK Development Environment: A Complete Guide](/mauriceboe/TREK/how-to-set-up-trek-development-environment)

Set up the TREK development environment quickly. Follow this guide to clone the repo, install dependencies, and run the full stack locally.

- Tags: how-to-guide
- Published: 2026-07-10

### [How Atlas Tracks Visited Countries and Sub-Regions in TREK: A Technical Deep Dive](/mauriceboe/TREK/how-does-atlas-track-visited-countries-and-sub-regions-in-trek)

Discover how Atlas tracks visited countries and sub-regions in TREK. Learn about the synchronized data sources and cached model within the useAtlas hook. A technical deep dive.

- Tags: deep-dive
- Published: 2026-07-09

### [How the AirTrail Flight Import Integration Works in TREK: A Technical Deep Dive](/mauriceboe/TREK/how-does-the-airtrail-flight-import-integration-work-with-trek)

Explore the TREK AirTrail flight import integration. Learn how to connect AirTrail, import reservations, and synchronize data bidirectionally with Bearer API authentication.

- Tags: deep-dive
- Published: 2026-07-09

### [How to Configure Auto-Backups with Retention Policies in TREK](/mauriceboe/TREK/how-to-configure-auto-backups-with-retention-policies-in-trek)

Easily configure auto-backups with retention policies in TREK. This guide shows you how to archive your SQLite database and uploads, automatically pruning old backups to save space.

- Tags: how-to-guide
- Published: 2026-07-09

### [TOTP Implementation in TREK: Complete Two-Factor Authentication Guide](/mauriceboe/TREK/what-is-the-implementation-of-two-factor-authentication-using-totp-in-trek)

Learn how TREK implements TOTP 2FA using otplib, AES-256-GCM encryption, and bcrypt hashing. Explore the three-stage REST API for secure authentication.

- Tags: how-to-guide
- Published: 2026-07-09

### [How SQLite Backup and Restore Works in TREK: Complete Technical Guide](/mauriceboe/TREK/how-does-sqlite-backup-and-restore-function-within-trek)

Discover how TREK backs up and restores SQLite databases by creating compressed archives, ensuring data integrity and seamless recovery. Learn the technical details.

- Tags: internals
- Published: 2026-07-09

### [How Budget Splitting and Settlement Calculation Work in TREK](/mauriceboe/TREK/how-does-budget-splitting-and-settlement-calculation-work-in-trek)

Uncover how TREK handles budget splitting and settlement calculation. Learn about its three-stage pipeline for expense division, multi-currency netting, and payment minimization.

- Tags: deep-dive
- Published: 2026-07-09

### [What Route Optimization Algorithm Does TREK Use for Day Planning?](/mauriceboe/TREK/what-is-the-route-optimization-algorithm-used-for-day-planning-in-trek)

Discover the greedy nearest-neighbor heuristic TREK employs for client-side route optimization in day planning. Learn about its O(N²) complexity.

- Tags: deep-dive
- Published: 2026-07-09

### [How TREK Implements PWA Offline Support Using Service Workers](/mauriceboe/TREK/how-does-trek-implement-pwa-offline-support-using-service-workers)

Discover how TREK leverages PWA offline support with Service Workers to cache API responses and map tiles, ensuring seamless functionality even without network access.

- Tags: how-to-guide
- Published: 2026-07-09

### [How to Configure Nginx or Caddy Reverse Proxy with WebSocket Support for TREK](/mauriceboe/TREK/how-to-configure-nginx-or-caddy-reverse-proxy-with-websocket-support-for-trek)

Configure Nginx or Caddy reverse proxy for TREK to enable WebSocket support. Learn to set timeouts and body size limits for seamless operation.

- Tags: how-to-guide
- Published: 2026-07-09

### [How TREK Implements Passkey and WebAuthn Passwordless Authentication](/mauriceboe/TREK/how-does-trek-handle-passkey-and-webauthn-passwordless-authentication)

Discover how TREK implements passkey and WebAuthn passwordless authentication using a three-layer architecture for secure, token-based login.

- Tags: how-to-guide
- Published: 2026-07-09

### [How to Configure OIDC/SSO Authentication with Google, Apple, or Authentik in TREK](/mauriceboe/TREK/how-to-configure-oidc-sso-authentication-with-google-apple-or-authentik-in-trek)

Configure OIDC SSO authentication with Google, Apple, or Authentik in TREK. Learn about automatic user provisioning, PKCE security, and admin interface for seamless integration.

- Tags: how-to-guide
- Published: 2026-07-09

### [How TREK Implements Real-Time Collaborative Sync Using WebSockets](/mauriceboe/TREK/how-does-trek-implement-real-time-collaborative-sync-using-websockets)

Discover how TREK implements real-time collaborative sync with WebSockets. Learn about server-side rooms, event broadcasting, and automatic client reconnection for seamless shared experiences.

- Tags: deep-dive
- Published: 2026-07-09

### [How to Configure OIDC_ONLY Mode for SSO-Only Authentication in TREK](/mauriceboe/TREK/configure-oidc-only-mode-sso-authentication-trek)

Secure your TREK instance by configuring OIDC_ONLY mode for SSO-only authentication. Disable password login and enforce OpenID Connect exclusively.

- Tags: how-to-guide
- Published: 2026-07-04

### [TREK Addons System Architecture: How Feature Modules Are Implemented](/mauriceboe/TREK/trek-addons-system-architecture)

Explore the TREK addons system architecture. Learn how feature modules are implemented using a centralized registry, database state, and runtime feature gating to manage MCP, AirTrail, and more.

- Tags: architecture
- Published: 2026-07-04

### [How to Set Up Auto-Backups with Configurable Retention in TREK](/mauriceboe/TREK/setup-auto-backups-configurable-retention-trek)

Learn to set up auto-backups with configurable retention in TREK. This guide explains how to protect your data with automatic ZIP archives and retention pruning via the Admin panel or REST API.

- Tags: how-to-guide
- Published: 2026-07-04

### [How the Journey Travel Journal Addon Integrates with Photo Providers in TREK](/mauriceboe/TREK/trek-journey-travel-journal-photo-provider-integration)

Discover how the TREK Journey addon integrates with photo providers like Immich and Synology Photos using a secure, three-layer architecture. Learn about credential encryption, request validation, and secure image streaming.

- Tags: how-to-guide
- Published: 2026-07-04

### [How to Configure Email Notifications with SMTP Settings in TREK](/mauriceboe/TREK/configure-email-notifications-smtp-trek)

Configure TREK email notifications using SMTP settings. Learn how to set up email alerts for password resets, trip invites, and booking changes via environment variables or the Admin UI.

- Tags: how-to-guide
- Published: 2026-07-04

### [TREK Environment Variables: Complete Configuration Guide for Advanced Deployment](/mauriceboe/TREK/trek-environment-variables-advanced-configuration)

Master advanced TREK deployment with our complete guide to TREK environment variables. Configure ports, encryption, SSO, passkeys, and more. Discover all options in server/src/config.ts.

- Tags: how-to-guide
- Published: 2026-07-04

### [How the Atlas World Map Addon Tracks Visited Countries in TREK](/mauriceboe/TREK/trek-atlas-world-map-addon-track-visited-countries)

Discover how the Atlas world map addon tracks visited countries in TREK. It uses manual inputs and automatic trip data with geocoding and caching for accurate country code resolution.

- Tags: internals
- Published: 2026-07-04

### [How to Set Up Document Management with File Attachments in TREK: A Complete Guide](/mauriceboe/TREK/setup-document-management-file-attachments-trek)

Learn to set up document management with file attachments in TREK. Configure permissions and use the FilesService API or useFileManager hook for real-time attachment management.

- Tags: how-to-guide
- Published: 2026-07-04

### [How TREK's Budget Splitting and Expense Settlement Feature Works](/mauriceboe/TREK/trek-budget-splitting-expense-settlement-feature)

Discover how TREK's budget splitting and expense settlement feature works. It simplifies multi-currency expense tracking and minimizes transfers using optimal repayment flows.

- Tags: feature-explanation
- Published: 2026-07-04

### [TREK Security Hardening Guide: Production Deployment Options](/mauriceboe/TREK/trek-security-hardening-production-deployment)

Learn how to harden your TREK production deployment. Secure your system with encryption, TLS, 2FA, and IP spoofing prevention. Protect your data effectively.

- Tags: best-practices
- Published: 2026-07-04

### [How to Enable and Configure the Vacay Vacation Planner Addon in TREK](/mauriceboe/TREK/enable-configure-vacay-addon-trek)

Enable and configure the Vacay vacation planner addon in TREK. Admins activate Vacay from the Add-ons page, then users set entitlements, holidays, and collaboration in the UI.

- Tags: how-to-guide
- Published: 2026-07-04

### [How to Set Up the AirTrail Addon for Flight Import Integration in TREK](/mauriceboe/TREK/setup-airtrail-addon-flight-import-trek)

Easily set up the AirTrail addon for flight import integration in TREK. Configure settings and import flights directly into trips via REST endpoints. Get started now!

- Tags: how-to-guide
- Published: 2026-07-04

### [How TREK Implements Offline PWA Mode with Service Worker Caching](/mauriceboe/TREK/trek-offline-pwa-mode-service-worker-caching)

Discover how TREK achieves offline PWA mode with Service Worker caching. Learn how map tiles, libraries, and trip data are stored for seamless offline access.

- Tags: how-to-guide
- Published: 2026-07-04

### [How to Configure Weather Forecasts Using Open-Meteo Integration in TREK](/mauriceboe/TREK/configure-weather-forecasts-open-meteo-trek)

Effortlessly configure weather forecasts in TREK with Open-Meteo integration. Get accurate forecasts without API keys, thanks to intelligent data selection and caching.

- Tags: how-to-guide
- Published: 2026-07-04

### [How the Route Optimization Algorithm Works in the TREK Trip Planner](/mauriceboe/TREK/trek-trip-planner-route-optimization-algorithm)

Discover how the TREK trip planner's route optimization algorithm uses nearest-neighbor and 2-opt to minimize travel distance while respecting fixed start and end points.

- Tags: deep-dive
- Published: 2026-07-04

### [How to Set Up Two-Factor Authentication (2FA) with TOTP in TREK](/mauriceboe/TREK/setup-two-factor-authentication-totp-trek)

Secure your TREK account with Time-Based One-Time Password (TOTP) 2FA. Follow our simple guide to set up and verify your TOTP codes for enhanced security.

- Tags: how-to-guide
- Published: 2026-07-04

### [Database Schema Structure for Trips and Reservations in TREK: A Complete Guide](/mauriceboe/TREK/trek-database-schema-trips-reservations)

Explore the TREK database schema structure for trips and reservations. Discover how Zod schemas manage travel metadata, computed stats, and normalized reservation tables efficiently.

- Tags: architecture
- Published: 2026-07-04

### [How TREK Implements Passkey WebAuthn Authentication: A Complete Technical Guide](/mauriceboe/TREK/trek-implement-passkey-webauthn-authentication)

Discover how TREK implements passkey WebAuthn authentication using a three-layer architecture for secure JWT sessions. Learn the technical details.

- Tags: deep-dive
- Published: 2026-07-04

### [How to Configure a Reverse Proxy (Nginx or Caddy) with WebSocket Support for TREK](/mauriceboe/TREK/configure-reverse-proxy-nginx-caddy-websocket-trek)

Learn to configure Nginx or Caddy as a reverse proxy for TREK with WebSocket support. Enable upgrades, set body limits, and configure environment variables for secure and efficient operation.

- Tags: how-to-guide
- Published: 2026-07-04

### [How MCP Scopes Control AI Permissions in TREK: A Complete Guide to OAuth 2.1 Access Control](/mauriceboe/TREK/trek-mcp-scopes-control-ai-permissions)

Master MCP scopes and OAuth 2.1 in TREK to precisely control AI permissions. Learn how 27 access tokens manage AI data read/write control, ensuring secure AI operations.

- Tags: tutorial
- Published: 2026-07-04

### [How TREK Handles Encryption Key Rotation for Production Deployments](/mauriceboe/TREK/trek-encryption-key-rotation-production-deployments)

Learn how TREK enables zero-downtime encryption key rotation for production with its Node.js migration script. It safely decrypts and re-encrypts secrets, ensuring secure data without service interruption.

- Tags: how-to-guide
- Published: 2026-07-04

### [How to Set Up and Use the Built-in MCP Server for AI Integration in TREK](/mauriceboe/TREK/setup-use-built-in-mcp-server-ai-integration-trek)

Learn to set up and use TREK's built-in MCP server for secure AI integration. Securely manage travel data with the OAuth 2.1 protected API.

- Tags: how-to-guide
- Published: 2026-07-04

### [How to Configure OIDC SSO with Authentik or Keycloak for TREK](/mauriceboe/TREK/configure-oidc-sso-authentik-keycloak-trek)

Learn how to configure OIDC SSO for TREK using Authentik or Keycloak. Integrate your preferred OIDC provider easily by setting issuer URLs and client credentials.

- Tags: how-to-guide
- Published: 2026-07-04

### [How Real-Time WebSocket Collaboration Works in TREK: A Technical Deep Dive](/mauriceboe/TREK/how-real-time-websocket-collaboration-work-trek)

Explore how TREK utilizes real-time WebSocket collaboration with JWT authentication and room-based architecture. Learn about synchronized trip data, ephemeral tokens, and broadcasting.

- Tags: deep-dive
- Published: 2026-07-04

### [Security Features in TREK: Data Encryption, 2FA, and Production Hardening](/mauriceboe/TREK/trek-security-features)

Explore TREK's robust security features. Discover AES-256 encryption, bcrypt hashing, TOTP 2FA, CSP headers, and rate limiting to protect your data.

- Tags: deep-dive
- Published: 2026-07-03

### [How TREK Handles Budget Tracking and Multi-Currency: A Technical Deep Dive](/mauriceboe/TREK/trek-budget-tracking-multi-currency)

Discover how the TREK app manages budget tracking and multi-currency expenses. It uses a dedicated add-on, real-time exchange rates, and WebSocket for seamless collaboration.

- Tags: deep-dive
- Published: 2026-07-03

### [Main Features of the TREK Trip Planning Module: A Technical Deep Dive](/mauriceboe/TREK/trek-trip-planning-features)

Explore the TREK trip planning module's main features: resizable workspace, tabbed itinerary, real-time collaboration, modular add-ons, and Zustand state management. Learn more now.

- Tags: deep-dive
- Published: 2026-07-03

### [How to Add Custom Addons to TREK: A Complete Implementation Guide](/mauriceboe/TREK/add-custom-addons-to-trek)

Learn how to add custom addons to TREK with this implementation guide. Register identifiers, insert seed records, and use isAddonEnabled utility for backend logic.

- Tags: how-to-guide
- Published: 2026-07-03

### [What Background Jobs Does the TREK Backend Run? A Complete Technical Guide](/mauriceboe/TREK/trek-backend-background-jobs)

Discover the nine background jobs the TREK backend runs for backups, cache, notifications, and data sync. Explore the scheduler for a complete technical guide.

- Tags: deep-dive
- Published: 2026-07-03

### [How TREK Manages File Uploads: NestJS and Multer Architecture Explained](/mauriceboe/TREK/trek-file-upload-management)

Discover how TREK manages file uploads with NestJS and Multer. Learn about its efficient architecture, security layers, and storage strategies.

- Tags: architecture
- Published: 2026-07-03

### [Where Is the SQLite Database Stored in TREK? File Path and Configuration Guide](/mauriceboe/TREK/trek-sqlite-database-location)

Discover where TREK stores its SQLite database at server/data/trek.db. Learn how to override the default SQLITE_PATH environment variable for custom configurations.

- Tags: how-to-guide
- Published: 2026-07-03

### [How is Authentication Handled in TREK: JWT, OAuth, and Passkeys Explained](/mauriceboe/TREK/trek-authentication-methods)

Discover TREK's layered authentication: JWT tokens, OAuth/OpenID Connect, and Passkeys. Learn how this secure system handles user access and identity management.

- Tags: deep-dive
- Published: 2026-07-03

### [What Is the Backend Stack for TREK? NestJS, Node.js & Real-Time Architecture Explained](/mauriceboe/TREK/trek-frontend-stack)

Discover the TREK backend stack featuring NestJS Nodejs and real-time architecture Explore its database authentication and WebSocket gateway implementation

- Tags: architecture
- Published: 2026-07-03

### [TREK Backend Stack: NestJS, Node.js 22, SQLite, and Real-Time WebSockets Explained](/mauriceboe/TREK/trek-backend-stack)

Explore the TREK backend stack: NestJS, Node.js 22, SQLite, and WebSockets for real-time sync. Learn about its Dockerized architecture and authentication options.

- Tags: architecture
- Published: 2026-07-03

### [How TREK Handles Real-Time Collaboration via WebSockets: Architecture & Implementation](/mauriceboe/TREK/trek-real-time-collaboration-websockets)

Discover how TREK implements real-time collaboration using WebSockets. Learn about its architecture, JWT authentication, ephemeral tokens, and state recovery for seamless synchronization.

- Tags: architecture
- Published: 2026-07-03

### [Available OAuth Scopes for TREK MCP: Complete Permissions Guide](/mauriceboe/TREK/trek-mcp-oauth-scopes)

Explore TREK MCP OAuth scopes. Understand 27 scopes across 13 groups, from read-only to destructive operations. Get the complete permissions guide for TREK MCP.

- Tags: api-reference
- Published: 2026-07-03

### [TREK MCP Server Tools and Resources: Complete API and Extension Guide](/mauriceboe/TREK/trek-mcp-tools-and-resources)

Explore TREK MCP server tools and resources including RESTful APIs, WebSocket, OAuth2, and add-on framework for extensible travel planning. Access the complete API and extension guide.

- Tags: api-reference
- Published: 2026-07-03

### [How to Configure MCP OAuth 2.1 for TREK: Complete Setup Guide](/mauriceboe/TREK/configure-mcp-oauth2-trek)

Master MCP OAuth 2.1 configuration for TREK. Follow our guide to set up authentication grants like authorization code and client credentials for seamless integration.

- Tags: how-to-guide
- Published: 2026-07-03

### [How to Integrate TREK with MCP (Model Context Protocol): A Complete Developer Guide](/mauriceboe/TREK/integrate-trek-mcp)

Integrate TREK with MCP using the built-in MCP server at /mcp. Securely query and manipulate travel data via JSON-RPC API. Follow this developer guide for easy setup.

- Tags: deep-dive
- Published: 2026-07-03

### [How to Set Up SSL for TREK with Nginx: Complete Configuration Guide](/mauriceboe/TREK/ssl-setup-nginx-trek)

Secure your TREK deployment with Nginx SSL. This guide configures Nginx as a reverse proxy to handle TLS termination, WebSocket upgrades, and forward traffic to your TREK application.

- Tags: how-to-guide
- Published: 2026-07-03

### [How to Configure Nginx as a Reverse Proxy for TREK](/mauriceboe/TREK/nginx-reverse-proxy-configuration-trek)

Learn to configure Nginx as a reverse proxy for TREK. Terminate TLS, forward traffic, proxy WebSocket upgrades, and set X-Forwarded-Proto headers for secure HTTPS handling. Optimize your TREK setup today.

- Tags: how-to-guide
- Published: 2026-07-03

### [TREK Docker Container Security Options: Image and Runtime Hardening Guide](/mauriceboe/TREK/trek-docker-security-options)

Explore TREK Docker container security. Learn about image and runtime hardening options including minimal images, non-root execution, read-only filesystems, and HTTPS hardening for enhanced security.

- Tags: how-to-guide
- Published: 2026-07-03

### [How to Configure TREK with Docker Compose for Production: A Complete Security Guide](/mauriceboe/TREK/docker-compose-production-setup-trek)

Securely configure TREK with Docker Compose for production using this comprehensive guide. Learn to leverage read-only filesystems and dropped capabilities for robust security.

- Tags: how-to-guide
- Published: 2026-07-03

### [TREK Docker Deployment Environment Variables: Complete Configuration Guide](/mauriceboe/TREK/trek-docker-environment-variables)

Master TREK Docker deployment by understanding its 40+ environment variables for server control, authentication, and more. Configure your TREK instance effectively.

- Tags: how-to-guide
- Published: 2026-07-03

### [How to Set Up TREK Using Docker: A Complete Self-Hosted Guide](/mauriceboe/TREK/how-to-set-up-trek-using-docker)

Easily set up TREK with Docker Compose. This self-hosted guide covers deploying the React frontend, Node.js API, and PostgreSQL database in minutes.

- Tags: how-to-guide
- Published: 2026-07-03

### [TREK Audit Log Events and Purpose: Complete Security Trail Guide](/mauriceboe/TREK/what-events-are-logged-by-the-audit-log-feature-in-trek-and-what-is-its-purpose)

Understand TREK audit log events like authentication, trip edits, and admin changes. Securely track and analyze activity for compliance and forensics with this essential guide.

- Tags: audit-guide
- Published: 2026-07-01

### [How TREK Handles Encryption Key Rotation for Data Security](/mauriceboe/TREK/how-does-trek-handle-the-rotation-of-encryption-keys-for-data-security)

Learn how TREK secures data with AES-256-GCM encryption and handles seamless encryption key rotation using a dedicated migration script without downtime. Ensure data integrity effortlessly.

- Tags: security
- Published: 2026-07-01

### [How the Journey Journal Feature Aggregates and Displays Information Across Multiple Trips in TREK](/mauriceboe/TREK/how-does-the-journey-journal-feature-aggregate-and-display-information-across-multiple-trips-in-trek)

Discover how TREK's Journey Journal aggregates and displays multi-trip data. Learn about chronological timelines, synchronized views, and client-side grouping logic for a unified experience.

- Tags: deep-dive
- Published: 2026-07-01

### [How TREK Implements Offline Mode and Progressive Web App (PWA) Functionalities](/mauriceboe/TREK/how-does-trek-implement-offline-mode-and-progressive-web-app-pwa-functionalities)

Learn how TREK leverages PWA, Workbox, and IndexedDB for a seamless offline travel experience. Discover their caching and data storage strategies for reliable map and trip access.

- Tags: deep-dive
- Published: 2026-07-01

### [How TREK's Undo Feature Tracks and Reverses User Actions in the Trip Planner](/mauriceboe/TREK/how-does-treks-undo-feature-internally-track-and-reverse-user-actions-within-the-trip-planner)

Explore how TREK's undo feature tracks and reverses user actions in the trip planner. Discover the LIFO history stack and callback mechanism within the usePlannerHistory hook.

- Tags: internals
- Published: 2026-07-01

### [Configurable WebSocket Transport Parameters and Rate Limits in TREK](/mauriceboe/TREK/what-are-the-configurable-websocket-transport-parameters-and-rate-limits-in-trek)

Learn about TREK's five tunable WebSocket settings for payload size, origin filtering, and message throttling. Configure WebSocket transport parameters and rate limits via environment variables or compile-time constants for opt...

- Tags: how-to-guide
- Published: 2026-07-01

### [What Is MCP in TREK? Enabling AI Assistant Integration with Claude and Cursor](/mauriceboe/TREK/what-is-mcp-in-trek-and-how-does-it-enable-integration-with-ai-assistants-like-claudeai-and-cursor)

Discover MCP in TREK, a protocol enabling AI assistant integration. Learn how it exposes trip data as an API for Claude and Cursor via JSON-RPC and OAuth.

- Tags: internals
- Published: 2026-07-01

### [How TREK's WebSocket Real-Time Synchronization Works Between Clients](/mauriceboe/TREK/how-does-treks-websocket-real-time-synchronization-function-between-clients)

Discover how TREK's WebSocket real-time synchronization connects clients. Learn about authenticated connections, trip rooms, and JSON event broadcasting for seamless trip data updates.

- Tags: internals
- Published: 2026-07-01

### [How the TREK Server Main Entry Point Connects to Core Modules: NestJS Bootstrap Architecture](/mauriceboe/TREK/what-is-the-relationship-between-the-main-entry-point-and-core-modules-in-trek-server)

Explore the TREK server's main entry point connection to core modules. Understand how NestJS bootstrap architecture wires global middleware and registers domain modules like Auth and Trips.

- Tags: internals
- Published: 2026-06-27

### [Design Principles Followed in TREK Server Development: A Modular NestJS Architecture](/mauriceboe/TREK/are-there-any-specific-design-principles-followed-in-trek-server-development)

Discover TREK server design principles: domain-driven modularity, dependency injection, and schema-first validation in NestJS. Learn about its flexible architecture.

- Tags: architecture
- Published: 2026-06-27

### [How the TREK Server Handles Persistence and Data Storage](/mauriceboe/TREK/how-does-the-trek-server-handle-persistence-or-data-storage)

Discover how the TREK server ensures data persistence using SQLite, automatic migrations, and type-safe queries via a NestJS service for robust application data storage.

- Tags: internals
- Published: 2026-06-27

### [What Kind of Output Does the TREK Server Produce?](/mauriceboe/TREK/what-kind-of-output-does-the-trek-server-produce)

Discover the TREK server's output: HTML assets for its React frontend, JSON for REST APIs, and binary streams like PDF exports. Learn more about TREK's versatile data delivery.

- Tags: api-reference
- Published: 2026-06-27

### [Main Entry Point File Responsibilities in the TREK React Application](/mauriceboe/TREK/what-are-the-main-responsibilities-of-the-main-entry-point-file)

Discover the core responsibilities of the main entry point file in the TREK React application. Learn how it bootstraps the app, sets up routing, and initializes crucial services.

- Tags: internals
- Published: 2026-06-27

### [How to Test the TREK Server Locally: Docker and Development Setup](/mauriceboe/TREK/how-can-i-test-the-trek-server-locally)

Easily test the TREK server locally using Docker for quick setup or run from source with npm run dev for full development control. Get your local TREK environment running fast.

- Tags: how-to-guide
- Published: 2026-06-27

### [What Are the Core Modules in the TREK Server? Purpose and Architecture](/mauriceboe/TREK/what-is-the-purpose-of-the-core-modules-in-trek-server)

Discover the purpose of TREK server core modules. Learn how they initialize the server, enforce security, and provide essential services like authentication and WebSocket sync for all addons and features.

- Tags: architecture
- Published: 2026-06-27

### [How to Contribute to the TREK Server Project: A Complete Developer's Guide](/mauriceboe/TREK/how-can-i-contribute-to-the-trek-server-project)

Contribute to the TREK server project easily. Fork the repository, branch from dev, and submit PRs with clear guidelines. Learn how to add your code to mauriceboe/TREK.

- Tags: how-to-guide
- Published: 2026-06-27

### [TREK Server Structure Explained: Architecture, Components, and Deployment Guide](/mauriceboe/TREK/is-there-a-readme-or-documentation-that-explains-the-trek-server-structure)

Understand the TREK server structure: NestJS, SQLite, WebSockets, and OAuth 2.1 MCP server. Deploy easily with Docker for real-time collaboration and AI assistants.

- Tags: architecture
- Published: 2026-06-27

### [TREK Server Dependencies: Complete Package Guide for Running the TREK Server](/mauriceboe/TREK/what-are-the-dependencies-for-running-the-trek-server)

Discover TREK server dependencies including NestJS 11 and better-sqlite3. Explore all 32 production dependencies for a robust TREK server setup.

- Tags: how-to-guide
- Published: 2026-06-27

### [How the TREK Server Handles Errors: A Dual-Stack Express and NestJS Error Management Strategy](/mauriceboe/TREK/how-does-the-trek-server-handle-errors)

Discover how the TREK server unifies error handling across Express and NestJS. Learn about its dual-stack strategy for consistent JSON error responses and HTTP status codes.

- Tags: internals
- Published: 2026-06-27

### [What Kind of Input Does the TREK Server Expect?](/mauriceboe/TREK/what-kind-of-input-does-the-trek-server-expect)

Discover the input TREK server expects including multipart form data for uploads, JSON for APIS, and URL-encoded params for auth. Learn how TREK processes requests.

- Tags: api-reference
- Published: 2026-06-27

### [How Configuration is Handled in the TREK Server: Environment Variables, File Persistence, and Runtime Constants](/mauriceboe/TREK/how-is-configuration-handled-in-the-trek-server)

Discover how TREK server manages configuration using environment variables, file persistence, and runtime constants for efficient application setup and operation.

- Tags: internals
- Published: 2026-06-27

### [Common Patterns Used in the TREK Server’s Core Modules: A NestJS Architecture Deep Dive](/mauriceboe/TREK/what-are-some-common-patterns-used-in-the-trek-server-s-core-modules)

Explore common NestJS design patterns in TREK server's core modules. Discover feature modules, DI, guards, interceptors, and Zod validation for modular, type-safe architecture.

- Tags: architecture
- Published: 2026-06-27

### [TREK Server Architecture: NestJS and Express Implementation Guide](/mauriceboe/TREK/can-you-provide-an-overview-of-the-trek-server-s-architecture)

Explore TREK server architecture. This NestJS and Express guide details TypeScript controllers, Express middleware, API serving, static assets, and WebSocket connections.

- Tags: architecture
- Published: 2026-06-27

### [What Does the Main Entry Point File in TREK Server Do?](/mauriceboe/TREK/what-does-the-main-entry-point-file-in-trek-server-do)

Discover the function of the TREK server main entry point file. Learn how it initializes the backend, bootstraps NestJS, launches schedulers, and manages shutdowns.

- Tags: internals
- Published: 2026-06-27

### [How to Explore the TREK Server Source Files: A Complete Monorepo Guide](/mauriceboe/TREK/how-can-i-explore-the-trek-server-s-source-files)

Easily explore TREK server source files with this monorepo guide. Start with main.ts, trace module imports, and use tests to navigate the architecture. Learn more about the TREK repository.

- Tags: how-to-guide
- Published: 2026-06-27

### [TREK Server Frameworks and Libraries: A Complete Technical Breakdown](/mauriceboe/TREK/are-there-any-specific-frameworks-or-libraries-heavily-used-in-trek-server)

Explore the TREK server frameworks and libraries. Discover NestJS, Express, Zod, RxJS, and essential authentication tools in this technical breakdown. Learn about TREK's core components.

- Tags: deep-dive
- Published: 2026-06-27

### [What Programming Language Is the TREK Server Written In?](/mauriceboe/TREK/what-programming-language-is-the-trek-server-written-in)

Discover that the TREK server is written in TypeScript and runs on Node.js with the NestJS framework. Learn key technical details about the mauriceboe/TREK repository.

- Tags: getting-started
- Published: 2026-06-27

### [How to Get Started with the TREK Server Code: A Complete Setup Guide](/mauriceboe/TREK/how-do-i-get-started-with-the-trek-server-code)

Get started with TREK server code. Learn to set up this NestJS 11 TypeScript app locally with npm or easily with Docker. Requires an ENCRYPTION_KEY.

- Tags: getting-started
- Published: 2026-06-27

### [TREK Server Features: Core Capabilities of the Node.js Travel Planning Backend](/mauriceboe/TREK/what-are-the-key-features-implemented-in-the-trek-server)

Explore TREK server features including multi-method authentication, real-time collaborative trip management, weather integration, and NestJS migration. Discover core Node.js capabilities.

- Tags: features
- Published: 2026-06-27

### [Where to Find Core Modules in the TREK Server Source Code](/mauriceboe/TREK/where-can-i-find-the-core-modules-in-the-trek-server-source-code)

Locate TREK server source code core modules in the server/src/nest/ directory. Discover over 35 domain-specific modules like Database, Weather, Trips, and Auth, all orchestrated by app.module.ts.

- Tags: internals
- Published: 2026-06-27

### [How the TREK Server Directory Structure Is Organized: A Complete Guide to the NestJS Backend](/mauriceboe/TREK/how-is-the-trek-server-directory-structure-organized)

Understand the TREK server directory structure. Explore the modular NestJS backend, from entry points and modules to services and testing, in this comprehensive guide.

- Tags: architecture
- Published: 2026-06-27

### [Main Entry Point for the TREK Server Application: Startup Flow Explained](/mauriceboe/TREK/what-is-the-main-entry-point-for-the-trek-server-application)

Discover the TREK server application's main entry point at server/src/index.ts. Learn how it bootstraps the NestJS application for core functionality.

- Tags: internals
- Published: 2026-06-27

### [Deploy TREK on Kubernetes with Helm: Complete Installation Guide](/mauriceboe/TREK/how-is-trek-deployed-on-kubernetes-using-helm-chart)

Deploy TREK on Kubernetes with its official Helm chart. Install the entire TREK application stack, including deployments, services, and PVCs, using a single Helm command.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Configure Reverse Proxy WebSocket Upgrades for TREK: Nginx and Caddy Setup](/mauriceboe/TREK/how-to-configure-reverse-proxy-for-websocket-upgrades)

Configure Nginx or Caddy for WebSocket upgrades to enable TREK's real-time features. Learn to forward headers, set timeouts, and manage upload limits for seamless collaboration.

- Tags: how-to-guide
- Published: 2026-06-26

### [How TREK Renders Interactive Maps with Leaflet and Mapbox GL (3D Buildings & Terrain)](/mauriceboe/TREK/how-are-interactive-maps-rendered-with-leaflet-and-mapbox-gl)

Discover how TREK renders interactive maps using Leaflet and Mapbox GL, featuring dynamic switching between raster tiles and 3D buildings and terrain. Explore the dual-provider architecture.

- Tags: how-to-guide
- Published: 2026-06-26

### [How TREK's PWA Implementation Enables Offline Support with Service Workers](/mauriceboe/TREK/how-does-treks-pwa-implementation-enable-offline-support)

Discover how TREK's PWA uses Service Workers to enable seamless offline support by caching API responses and map tiles. Learn about data clearing and auth updates.

- Tags: how-to-guide
- Published: 2026-06-26

### [How WebSocket Message Rate Limiting (30 msg/10s) Prevents Abuse in TREK](/mauriceboe/TREK/how-does-websocket-message-rate-limiting-prevent-abuse)

Discover how TREK's WebSocket message rate limiting (30 msg/10s) stops DoS attacks and spam by automatically rejecting excess traffic, ensuring server stability and preventing resource exhaustion.

- Tags: best-practices
- Published: 2026-06-26

### [How Packing Lists Are Managed with Templates, Member Assignments, and Bag Tracking in TREK](/mauriceboe/TREK/how-are-packing-lists-managed-with-templates-and-tracking)

Discover how TREK manages packing lists with templates, member assignments, and bag tracking. Learn about its relational architecture and permission system for efficient organization.

- Tags: how-to-guide
- Published: 2026-06-26

### [How Photo Providers (Immich & Synology) Integrate with the Journey Addon in TREK](/mauriceboe/TREK/how-do-photo-providers-integrate-with-journey-addon)

Discover how Immich and Synology photo providers integrate with the Journey addon in TREK using server-side credentials, proxy streaming, and a REST API for seamless asset referencing without data duplication.

- Tags: how-to-guide
- Published: 2026-06-26

### [How TREK Fetches 16-Day Forecasts from the Open-Meteo API](/mauriceboe/TREK/how-does-weather-service-fetch-16-day-forecasts-from-open-meteo)

Learn how the TREK backend fetches 16-day weather forecasts from the Open-Meteo API by validating dates, querying endpoints, and transforming weather codes. Results are cached for one hour.

- Tags: how-to-guide
- Published: 2026-06-26

### [How OIDC SSO Integration Works with Claims-Based Admin Mapping in TREK](/mauriceboe/TREK/how-does-oidc-sso-integration-work-with-claims-based-admin-mapping)

Learn how TREK's OIDC SSO integration uses claims-based admin mapping to automatically grant admin roles based on group claims, enhancing security and simplifying access management.

- Tags: deep-dive
- Published: 2026-06-26

### [How JWT Authentication Is Implemented in the NestJS Backend with Session Duration Controls](/mauriceboe/TREK/how-is-jwt-authentication-implemented-in-nestjs-backend)

Learn how JWT authentication is implemented in NestJS with TREK. Discover how signed JWTs, secure cookies, and session duration controls enhance backend security. Explore middleware verification and centralized configuration fo...

- Tags: deep-dive
- Published: 2026-06-26

### [How Real-Time Collaboration Is Implemented with WebSocket Room-Based Trip Channels in TREK](/mauriceboe/TREK/how-is-real-time-collaboration-implemented-with-websocket-room-based-trip-channels)

Discover how TREK uses WebSocket room-based trip channels for real-time collaboration. Learn how the server broadcasts updates efficiently to users within specific trip rooms.

- Tags: internals
- Published: 2026-06-26