Wanderer

Wanderer

Docker app from grtgbln's Repository

Overview

A self-hosted trail database. You can upload your recorded tracks or create new ones and add various metadata to build an easily searchable catalogue.
This is the web component.

The trail catalogue that makes your GPS data searchable

Docker Image Version (tag latest semver) GitHub Repo stars Buy Me A Coffee Discord

Try the demo

wanderer is a self-hosted trail database. You can upload your recorded tracks or create new ones and add various metadata to build an easily searchable catalogue.

Core Features

Screenshot of wanderer

  • Manage your trails
  • Plan new routes
  • Extensive map integration and visualization
  • Share trails with other people and explore theirs
  • Advanced filter and search functionality
  • Create custom lists to organize your trails further

Getting started

The recommended and quickest way to install wanderer is using docker compose:

# download the docker compose file
wget https://raw.githubusercontent.com/open-wanderer/wanderer/main/docker-compose.yml

# build and launch via docker compose
docker compose up -d

The first startup can take up to 90 seconds after which you can access the frontend at localhost:3000.

ℹ️ if you are not hosting wanderer at http://localhost:3000 make sure to change ORIGIN variable. Otherwise you will run into CORS errors.

⚠️ if you are using wanderer in a production environment make sure to change the MEILI_MASTER_KEY variable.

You can also run wanderer on bare-metal. Check out the documentation for a detailed how-to guide.

Support wanderer

If you like wanderer and would like to give something back you can donate over here. If you prefer to support the development with a regular contribution you can donate via Liberapay.

Documentation

Please check the website for the complete documentation.

Contributing

Help is welcome at any time. If you are not sure where you can start check the roadmap for features in the backlog. If you would like to contribute a translation, you can do so here.

License

This project is licensed under the AGPLv3 License. See the LICENSE file for the full license text.

Media gallery

Install Wanderer on Unraid in a few clicks.

Find Wanderer in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Wanderer Review the template variables and paths Click Install

Requirements


        Requires a separate Wanderer - Database container and a separate Meilisearch container.
    

Download Statistics

400,255
Total Downloads
36,303
This Month
31,524
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
flomp/wanderer-web:latest
Last Updated2026-06-18
First Seen2025-01-27

Runtime arguments

Web UI
http://[IP]:[PORT:3000]/
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Container Port: 3000

Target
3000
Default
3000
Value
3000
Meilisearch - URLVariable

URL of the Meilisearch instance

Target
MEILI_URL
Default
http://meilisearch:7700
Value
http://meilisearch:7700
Meilisearch - Master KeyVariable

Master key for the Meilisearch instance

Target
MEILI_MASTER_KEY
Database - URLVariable

URL of the Wanderer - Database instance

Target
PUBLIC_POCKETBASE_URL
Default
http://wanderer-db:8090
Value
http://wanderer-db:8090
Disable SignupsVariable

Disable the ability to sign up

Target
PUBLIC_DISABLE_SIGNUP
Default
false|true
Uploads PathPath

Path to uploaded files

Target
/app/uploads
Default
/mnt/user/appdata/wanderer/uploads
Value
/mnt/user/appdata/wanderer/uploads
OriginVariable

Origin of the web app

Target
ORIGIN
Default
http://localhost:3000
Value
http://localhost:3000
Body Size LimitVariable

Maximum size of the body

Target
BODY_SIZE_LIMIT
Default
Infinity
Value
Infinity
Internal Uploads PathVariable

Path to uploaded files

Target
UPLOAD_FOLDER
Default
/app/uploads
Value
/app/uploads
Upload UserVariable

User to upload files

Target
UPLOAD_USER
Upload PasswordVariable

Password to upload files

Target
UPLOAD_PASSWORD
Public Valhalla URLVariable

URL of the Valhalla instance

Target
PUBLIC_VALHALLA_URL
Default
https://valhalla1.openstreetmap.de
Value
https://valhalla1.openstreetmap.de
Public Nominatim URLVariable

URL of the Nominatim instance

Target
PUBLIC_NOMINATIM_URL
Default
https://nominatim.openstreetmap.org
Value
https://nominatim.openstreetmap.org