https://github.com/flomp/wanderer

wanderer is a self-hosted trail database. Save your adventures!
https://github.com/flomp/wanderer

geography gps meilisearch pocketbase selfhosted sveltekit

Last synced: 9 days ago
JSON representation

wanderer is a self-hosted trail database. Save your adventures!

• Host: GitHub
• URL: https://github.com/flomp/wanderer
• Owner: Flomp
• License: agpl-3.0
• Created: 2024-01-27T15:11:51.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-11T14:43:33.000Z (10 days ago)
• Last Synced: 2025-04-12T21:18:45.362Z (9 days ago)
• Topics: geography, gps, meilisearch, pocketbase, selfhosted, sveltekit
• Language: HTML
• Homepage:
• Size: 156 MB
• Stars: 1,894
• Watchers: 13
• Forks: 63
• Open Issues: 36
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        


  

  
The trail catalogue that makes your GPS data searchable


[![Docker Image Version (tag latest semver)](https://img.shields.io/docker/v/flomp/wanderer-web/latest)](https://github.com/Flomp/wanderer/)

[![GitHub Repo stars](https://img.shields.io/github/stars/flomp/wanderer?style=social)](https://github.com/Flomp/wanderer/)

[![Buy Me A Coffee](https://img.shields.io/badge/Support-wanderer-yellow?logo=buy-me-a-coffee)](https://www.buymeacoffee.com/wanderertrails)

[![Discord](https://img.shields.io/discord/1249895457396621332?style=social&logo=discord&label=Developer%20Discord)](https://discord.gg/USSEBY98CP)

[![Try the demo](https://img.shields.io/badge/Try_the_demo-EF2D5E?style=for-the-badge&logoColor=white&logo=rocket&color=2a56f1&labelColor=242734)](https://demo.wanderer.to)



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](docs/src/assets/hero.png)

- 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:

``` bash

# download the docker compose file

wget https://raw.githubusercontent.com/Flomp/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](https://wanderer.to/getting-started/installation/#from-source) for a detailed how-to guide.

## Support wanderer

If you like wanderer and would like to give something back you can donate over [here](https://www.buymeacoffee.com/wanderertrails).

## Documentation

Please check the [website](https://wanderer.to) for the complete documentation.

## Contributing

Help is welcome at any time. If you are not sure where you can start check the [roadmap](https://github.com/users/Flomp/projects/2/views/1) for features in the backlog.

If you would like to contribute a translation, you can do so [here](https://crowdin.com/project/wanderer).

## License

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