Self-host roadbook
v0.1.4Map-based itinerary planner with AI assistance
- Stars
- 23
- Ports
- 80 (Nginx HTTP server (frontend + API proxy)), 5436 (Backend Go API server)
chenxuan520/roadbook
What is roadbook?
RoadbookMaker lets users build travel plans on interactive maps by adding markers, connecting them with routes across seven transport modes, and exporting the result as JSON, HTML, ICS calendars, or PNG long-images. It offers multiple map layers including OpenStreetMap, Gaode, Google Maps, and ESRI imagery, plus integrated search across Photon, Nominatim, Overpass, and Chinese providers. An AI assistant can generate multi-day itineraries from natural language prompts when a compatible API key is configured in the self-hosted backend. The app works fully offline using browser localStorage with no account required, or can be self-hosted via Docker, a compiled Go binary behind Nginx, or Cloudflare Workers for cloud synchronization and sharing. Authentication uses JWT with configurable users. Core features require no external API keys.
Should you self-host roadbook?
roadbook scores 36/100 on selfhost.directory (how scoring works) and ranks #7 of 9 in Mapping & GPS. It has 23 GitHub stars.
It shipped 10 stable releases in the past year. The latest, v0.1.4, came out on 23 March 2026. New versions land roughly every 3 days.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in JavaScript.
Its closest alternative on selfhost.directory is God's Eye View (83/100, 60 810 stars). It scores higher overall, so compare the two before you pick. See roadbook vs God's Eye View side by side.
Features
- AI itinerary generationRequires self-hosted backend with configured AI provider API key
- Cloud sync & sharingRequires self-hosted backend (Docker, binary, or Cloudflare Workers)
- Coordinate conversion
- Cost Tracking
- Data Export
- Hotel search integration
- Integrated search
- Keyboard Shortcuts
- Map marking
- Multiple map sources
- Navigation integration
- Offline First
- Route Planning
- Ticket booking integration
roadbook README
More in Navigation
smsSelf-hosted vector tile server serving OSM data from MBTiles with hiking/cycling routing, SAC ratings, and MCP for LLM agents to plan tours.
Sun-PanelSelf-hosted icon navigation panel and browser start page for servers, NAS boxes and Docker containers, with multi-account isolation and no external database.
ValhallaValhalla is a self-hosted, open-source routing engine for OpenStreetMap with turn-by-turn navigation, isochrones, matrix computation, map matching, and tour optimization.
Vanchor-NGSelf-hosted GPS autopilot turning a trolling motor into a virtual anchor with routing and fishing modes — runs offline on Raspberry Pi or in simulation.
facilmapFacilMap is a self-hosted, open-source OpenStreetMap web map for collaborative maps with markers, routes, live editing, multiple styles, routing, and GPX/GeoJSON import.
GraphHopperGraphHopper is a self-hosted, open-source OpenStreetMap routing engine with A-to-B routing, isochrones, map matching, and GTFS transit. Runs as Java server or library.
HaukHauk is an open-source, self-hosted real-time location sharing service with PHP backend and Android app. Run your own server and share location via generated links.
MBCompassAn open-source, self-hosted-on-device Android compass app: GPS location, track recording, GPX export, offline Mapsforge maps, zero ads or tracking.
OpenRouteServiceSelf-hosted, open-source Java routing API on OpenStreetMap data offering directions, isochrones, time-distance matrices, snapping and graph export.
Open Source Routing Machine (OSRM)An open-source routing engine you self-host to answer route, matrix, map-matching, trip and tile queries over OpenStreetMap extracts via HTTP.
OpenStreetMapOpen-source, self-hosted Ruby on Rails app powering the OpenStreetMap website and its XML/JSON editing API, with accounts, GPX traces and diaries, backed by PostgreSQL.
OpenTripPlannerSelf-hosted, open-source trip planner for scheduled public transit plus walking, cycling and bikeshare, built from GTFS/NeTEx and OpenStreetMap data.
0 comments