OpenSource-Hub
W

wanderer

3.6k stars·File Management·SHA-256 checksum verified

Self-hosted trail database to upload, manage, and search GPS tracks with rich metadata and maps.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Self-host your GPS trail collection with powerful search and sharing.

Core Features

  • Upload or create GPS tracks with metadata (difficulty, photos, notes)
  • Full-text search & filtering using MeiliSearch engine
  • Integrated map viewer with multiple tile layers and elevation profile
  • Share trails and explore others’ public routes
  • Organize trails into custom lists

What It Can't Do

  • ⚠️ Change the ORIGIN env var in docker-compose.yml if not hosting at localhost:3000 (otherwise CORS errors).
  • ⚠️ Replace the default MEILI_MASTER_KEY with a strong password in production.
  • ⚠️ First startup takes ~90 seconds.

Use Cases

  • Manage all your hiking/biking/running GPX files in one private catalog
  • Clubs or groups share trails internally without relying on commercial platforms
  • Privacy-conscious users who want full control over location data

Detailed Introduction

wanderer is a self-hosted trail database that lets you upload recorded GPS tracks or create new routes, then enrich them with metadata like difficulty, photos, and notes. Its powerful search engine (MeiliSearch) makes finding trails instant. You can share trails with others, explore their collections, and organize everything into custom lists. The integrated map viewer supports multiple tile layers and elevation profiles. Designed for hikers, cyclists, and outdoor enthusiasts who want full control over their data without relying on commercial platforms like AllTrails or Strava. Runs via Docker Compose for easy deployment.

Troubleshooting & FAQ (1)

Troubleshooting
Why do I get 'invalid API key' error from Meilisearch after restoring a PocketBase backup?

This happens because the MeiliSearch API key stored in PocketBase does not match the keys in your current Meili instance. To fix, also restore the MeiliSearch data volume (the /meili_data/data.ms folder) from the same backup. If not backed up, you may need to re-create the index by re-uploading trails, or reconfigure the API key in PocketBase settings.

GitHub Issue #401

Tags

GPStrailself-hostedmapsearchoutdoordocker

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Install Docker & Docker Compose

4

Step 2: Download docker-compose.yml: wget https://raw.githubusercontent.com/open-wanderer/wanderer/main/docker-compose.yml

5

Step 3: Run 'docker compose up -d' and wait ~90 seconds

Install Guide
  1. Step 1: Install Docker & Docker Compose
  2. Step 2: Download docker-compose.yml: wget https://raw.githubusercontent.com/open-wanderer/wanderer/main/docker-compose.yml
  3. Step 3: Run 'docker compose up -d' and wait ~90 seconds
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Run 'docker compose down' to stop containers, then remove volumes with 'docker volume rm' commands to erase all data.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseAGPL-3.0
Last Updated2026-06-26 18:55:16
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects