Open-source fuel and EV route planner with live prices from 22 countries. Self-hostable.
Pumperly is a map of fuel prices and EV chargers with a route planner on top. Pick a destination and it draws the route, lists every station along it with its price and the minutes a stop would add, and plans the cheapest places to fill up. Prices come from government and community sources in 22 countries with no key to set. Try it at pumperly.com, or run your own copy with Docker Compose.
- Shows every station on the map coloured by price, green for the cheapest 5% on screen to purple for the most expensive.
- Lists the stations along your route with the extra minutes each one costs, and hides the ones past the detour you allow.
- Plans the cheapest fuel stops for the trip from your tank size, consumption and how full you start.
- Keeps prices fresh from 22 countries with no API key, and from two more with a free key. Supports 39 countries in all, each listed with its status.
- Shows EV chargers from the official registries of Spain and Germany and from Open Charge Map everywhere else.
- Converts prices into 37 currencies with the European Central Bank's daily rates, and speaks 17 languages.
- Makes any station or route a link you can share.
- Runs as one container next to PostGIS, with Valhalla and Photon optional, and keeps no accounts, no analytics and no tracking cookies.
git clone https://github.com/GeiserX/Pumperly.git && cd Pumperly && cp .env.example .env
docker compose -f docker/docker-compose.yml up -dOpen http://localhost:3000. The map fills country by country over the next few minutes as the scrapers run. This first run has the price map only: routes and address search need Valhalla and Photon, which Full stack with routing and geocoding adds. Run with Docker Compose explains the settings in .env.
The full documentation lives at geiserx.github.io/Pumperly.
- Run with Docker Compose: the shipped compose file, the settings in
.env, and what to do before exposing it. - What happens on first start: the scrapers, their timetable, and how to check that it worked.
- Full stack with routing and geocoding: Valhalla and Photon, with the compose file that runs all of it.
- The map and Planning a route: every control, the price colours, detours and the refuel planner.
- Coverage and status: every country, its source and whether it works today.
- Environment variables and the HTTP API.
pumperly-mcp (MCP server), pumperly-ha (Home Assistant), n8n-nodes-pumperly (n8n node, archived). Also listed on awesome-europe and ArtifactHub.
AGPL-3.0-or-later. If you run a modified version as a network service, you must offer its source code to the users of that service.