Free, privacy-first offline maps and GPS navigation app for Android and iOS, built on crowd-sourced OpenStreetMap data.
- Stars
- 4,054
- Forks
- 209
- Open issues
- 93
- Last commit
- 7 hours ago
What is it?
wanderer is a self-hosted trail database for people who record GPS tracks from hikes, bike rides and other outdoor activities. You can upload recorded tracks or create new routes, attach metadata to each one, and build a catalogue that is easy to search and filter.
The app combines trail management with route planning and map visualization. Trails can be shared with other users, who can explore each other's collections, and custom lists let you group trails beyond the built-in filters. Search is handled by Meilisearch, and the stack is built on PocketBase and SvelteKit.
The recommended install is Docker Compose, using a setup script that generates fresh secrets. Bare-metal installation is also documented.
Key features
- 01Upload recorded GPS tracks or create new trails
- 02Plan new routes on an interactive map
- 03Add metadata and organize trails with custom lists
- 04Advanced filtering and search across your catalogue
- 05Share trails with other users and browse theirs
Use cases
- Cataloguing years of hiking and cycling tracks in one searchable place
- Planning a multi-day route and sharing it with friends
- Keeping a private, self-hosted record of outdoor adventures
Quick start
- 1
Run the official setup script from the README to create docker-compose.yml with fresh secrets
- 2
Launch wanderer with Docker Compose
docker compose up -d - 3
Open the frontend at localhost:3000 after the first startup (allow up to 90 seconds)
Things to know
- Licensed under AGPL-3.0, a copyleft license that requires derivative network services to share their source code.
- Self-hosting is required; there is no hosted service described in the README beyond a demo.
- If not hosted at localhost:3000, the ORIGIN variable must be changed to avoid CORS errors.
In collections
Topics
FAQ
- What is wanderer?
- A self-hosted trail database for uploading GPS tracks, planning routes and building a searchable catalogue of your hikes and rides. wanderer is a self-hosted trail database for people who record GPS tracks from hikes, bike rides and other outdoor activities. You can upload recorded tracks or create new routes, attach metadata to each one, and build a catalogue that is easy to search and filter.
- Is wanderer free to use? What license does it have?
- wanderer is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
- Is wanderer still maintained?
- Actively maintained. The last commit to wanderer was on Nov 6, 2026.
- What can I use wanderer for?
- Cataloguing years of hiking and cycling tracks in one searchable place Planning a multi-day route and sharing it with friends Keeping a private, self-hosted record of outdoor adventures
- How do I install wanderer?
- Run the official setup script from the README to create docker-compose.yml with fresh secrets Launch wanderer with Docker Compose: docker compose up -d Open the frontend at localhost:3000 after the first startup (allow up to 90 seconds)
- Where can I get wanderer?
- The source code and installation instructions are on GitHub: https://github.com/open-wanderer/wanderer
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A self-hosted homelab dashboard with GUI-based editing, built-in SSO authentication, RSS news, widgets, and integrations with self-hosted apps.
Self-hostable location history tracker and web app that replaces Google Timeline, with maps, trips, stats and imports from several sources.
Self-hostable travel tracker that logs visited places, plans multi-day trips, and maps countries and regions on one world map.
Offline-capable map and navigation app for Android and iOS, built on OpenStreetMap data with turn-by-turn routing for car, bike and pedestrian use.
Official firmware for Meshtastic, open-source LoRa mesh radios for off-grid text messaging, location sharing and telemetry.