# pumperly

pumperly is an open-source fuel price comparison and electric vehicle (EV) route planner with live prices in 22 countries. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2005/pumperly

## Description

Pumperly is an open-source fuel price comparison and electric vehicle (EV) route planner with live prices in 22 countries. It maps fuel stations and EV chargers, draws a route to your destination, lists each stop with its price and added detour time, and plans the cheapest places to fill up. Multi-language (16 languages) and multi-currency, with no data keys to set. Requires PostgreSQL with the PostGIS extension; optional Valhalla (routing) and Photon (geocoding) containers add full functionality, and full Valhalla tile builds need roughly 300 GB disk and 24 GB RAM.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

68/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 12 days ago)
- Popular: 34 (47 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/drumsergio/pumperly
- Official website: https://geiserx.github.io/Pumperly/
- Unraid: https://ca.unraid.net/apps/pumperly-1nk242h1qjji65?q=pumperly

## Common questions

### How do I start Pumperly for the first time?

Clone the repository, copy the example environment file to .env, start the Docker Compose stack, and open the app on port 3000. The map fills in as the scrapers run.

### Do I need Valhalla and Photon for the basic setup?

They are optional. The first Docker Compose run provides the price map only, while route planning and address search require Valhalla and Photon.

### Do I need API keys to get fuel prices?

Pumperly pulls prices from 22 countries without a key and from two more countries with a free key, covering 39 countries in total.

### How can I check whether scraping is working or fix a failing country?

The troubleshooting guide covers monitoring, log interpretation, common failures, and running a single country scraper by hand.

### Does Pumperly require user accounts or collect tracking data?

It keeps no accounts, no analytics, and no tracking cookies.

---
Source: Our Local Host (https://ourlocalhost.com/app/2005/pumperly), the self-hosted and open-source app directory.
