{
  "schema_version": 1,
  "generated_at": "2026-10-22T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/wanderer",
  "slug": "wanderer",
  "name": "Wanderer",
  "tagline": "Trail database for saving and sharing routes and hikes.",
  "replaces": {
    "summary": "Paid trail map services, such as AllTrails.",
    "products": [
      {
        "slug": "alltrails",
        "name": "AllTrails",
        "vendor": "AllTrails",
        "url": "https://openlogs.fyi/alternatives/alltrails"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Go"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "AGPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "3 services (1 database or broker: meilisearch), 4 volume mounts, 2 env values to set, no elevated host access. Heuristic score 5 of 11: medium."
  },
  "repository": {
    "owner": "open-wanderer",
    "name": "wanderer",
    "url": "https://github.com/open-wanderer/wanderer"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker-compose.yml",
    "source_repo": "open-wanderer/wanderer",
    "source_commit_sha": "298d3369354862d96bd1f769880a047ca90e2b2e",
    "source_kind": "app_repo",
    "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin",
      "body": "A host with Docker and the Docker Compose plugin. This entry runs from a compose file.",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the compose file as docker-compose.yml",
      "body": "version: '3'\n\nx-common-env: &cenv\n  MEILI_URL: http://search:7700\n  MEILI_MASTER_KEY: vODkljPcfFANYNepCHyDyGjzAMPcdHnrb6X5KyXQPWo\n\nservices:\n  search:\n    container_name: wanderer-search\n    image: getmeili/meilisearch:v1.36.0\n    environment:\n      <<: *cenv\n      MEILI_NO_ANALYTICS: \"true\"\n    ports:\n      - 7700:7700\n    networks:\n      - wanderer\n    volumes:\n      - ./data/data.ms:/meili_data/data.ms\n    restart: unless-stopped\n    healthcheck:\n      test: curl --fail http://localhost:7700/health || exit 1\n      interval: 15s\n      retries: 10\n      start_period: 20s\n      timeout: 10s\n  db:\n    container_name: wanderer-db\n    image: flomp/wanderer-db\n    depends_on:\n      search:\n        condition: service_healthy\n    environment:\n      <<: *cenv\n      POCKETBASE_ENCRYPTION_KEY: fde406459dc1f6ca6f348e1f44a9a2af\n      POCKETBASE_PROXY_SECRET: dev-proxy-secret-change-me\n      ORIGIN: http://localhost:3000\n    ports:\n      - \"8090:8090\"\n    networks:\n      - wanderer\n    restart: unless-stopped\n    volumes:\n      - ./data/pb_data:/pb_data\n      - ./data/plugins:/data/plugins\n    healthcheck:\n      test: [\"CMD\", \"/curl\", \"--fail\", \"http://localhost:8090/health\"]\n      interval: 15s\n      retries: 10\n      start_period: 20s\n      timeout: 10s\n  web:\n    container_name: wanderer-web\n    image: flomp/wanderer-web\n    depends_on:\n      search:\n        condition: service_healthy\n      db:\n        condition: service_healthy\n    environment:\n      <<: *cenv\n      ORIGIN: http://localhost:3000\n      BODY_SIZE_LIMIT: Infinity\n      POCKETBASE_PROXY_SECRET: dev-proxy-secret-change-me\n      PUBLIC_POCKETBASE_URL: http://db:8090\n      PUBLIC_DISABLE_SIGNUP: \"false\"\n      UPLOAD_FOLDER: /app/uploads\n      UPLOAD_USER:\n      UPLOAD_PASSWORD:\n      OVERPASS_API_URL: https://overpass-api.de\n      VALHALLA_URL: https://valhalla1.openstreetmap.de\n      NOMINATIM_URL: https://nominatim.openstreetmap.org\n      PUBLIC_MAP_MAX_POLYLINES: 100\n    volumes:\n      - ./data/uploads:/app/uploads\n      # - ./data/about.md:/app/build/client/md/about.md\n    ports:\n      - \"3000:3000\"\n    networks:\n      - wanderer\n    restart: unless-stopped\n    healthcheck:\n      test: [\"CMD\", \"curl\", \"--fail\", \"http://localhost:3000/\"]\n      interval: 15s\n      retries: 10\n      start_period: 20s\n      timeout: 10s\n# valhalla:\n#   image: ghcr.io/gis-ops/docker-valhalla/valhalla:latest\n#   ports:\n#     - \"8002:8002\"\n#   volumes:\n#     - ./data/valhalla:/custom_files\n#   environment:\n#     - tile_urls=https://download.geofabrik.de/europe/germany/bayern/oberbayern-latest.osm.pbf\n#     - use_tiles_ignore_pbf=True\n#     - force_rebuild=False\n#     - force_rebuild_elevation=False\n#     - build_elevation=True\n#     - build_admins=True\n#     - build_time_zones=True\n\nnetworks:\n  wanderer:\n    driver: bridge\n",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "env",
      "language": "text",
      "label": "Set the values the compose file needs",
      "body": "These variables have no default in the compose file: UPLOAD_PASSWORD, UPLOAD_USER. Compose reads them from the shell or from a .env file next to the compose file. Replace the placeholder values listed under Gotchas.",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:3000. The compose file publishes host port 3000 for the web service.",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: db: flomp/wanderer-db (no tag), web: flomp/wanderer-web (no tag). A later pull can get a different version.",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file has placeholder values",
      "body": "Placeholder values: POCKETBASE_PROXY_SECRET is \"dev-proxy-secret-change-me\" (db), POCKETBASE_PROXY_SECRET is \"dev-proxy-secret-change-me\" (web).",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 7700 (search), 8090 (db), 3000 (web). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: ./data/data.ms at /meili_data/data.ms (search), ./data/pb_data at /pb_data (db), ./data/plugins at /data/plugins (db), ./data/uploads at /app/uploads (web).",
      "source_url": "https://github.com/open-wanderer/wanderer/blob/298d3369354862d96bd1f769880a047ca90e2b2e/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 4014,
    "forks": 201,
    "open_issues": 92,
    "last_push": "2026-10-21",
    "days_since_push": 0,
    "latest_release": "v0.21.0",
    "latest_release_date": "2026-09-28",
    "days_since_release": 23
  },
  "links": {
    "html": "https://openlogs.fyi/tools/wanderer",
    "markdown": "https://openlogs.fyi/tools/wanderer.md",
    "json": "https://openlogs.fyi/tools/wanderer.json"
  },
  "updated_at": "2026-10-22"
}