Every flight you've ever taken
Forward a booking confirmation. TravStats reads the route, draws the arc on your globe, and remembers it forever — from the first transatlantic to last weekend's hop.
Your trips · Your map · Your story
Every trip you've taken,
on one map.
Forward a booking email — TravStats reads it, draws the route on your globe, and never lets your data leave your server.
How it works
Drop a booking email in. Get the journey out.
TravStats reads the confirmations airlines, cruise lines and hotels send you anyway — as a forwarded mail, a .msg or .eml file, a PDF, or a photo of a bill. A document announces itself as a flight, a cruise or a hotel; a boarding pass is read by its barcode first; a marketing newsletter does not become a flight. Every other detail stays where it was. Pick a sample below to see what the parser sees.
[SIMULATED BOOKING CONFIRMATION]
From: [email protected]
Subject: Booking confirmation — your flight LH 401
Dear Traveling Tom,
Thank you for booking with Lufthansa. Your reservation is
confirmed.
Booking reference: X1Y2Z3
Frequent flyer: ******5678
FLIGHT DETAILS
Flight: LH 401
Date: 15 June 2026
Departure: Frankfurt (FRA), Terminal 1, 10:35
Arrival: New York JFK (JFK), Terminal 1, 13:25
Passenger: TRAVELING/TOM
Class: Economy (Y)
Seat: 24A
Total paid: € 583.40 (Card ending **** 1234)
Extracted
Flight
LH 401
From
Frankfurt (FRA)
To
New York JFK (JFK)
Date
15 June 2026
Cabin
Economy
Added to your logbook — visible on the globe.
Privacy mode active. These are fictional booking confirmations with fake passenger names, PNRs and card numbers. In your own self-hosted TravStats, your real emails are parsed locally — they never leave your server.
Best results come from the Ollama parser (local LLM, recommended). Without an LLM, the deterministic templates — Booking.com, known airlines, package-tour documents — and the document detection still run; anything no template recognises needs Ollama.
What it looks like
A logbook you'll actually open.
The web UI runs on your laptop, your tablet and your phone. Five views you will spend most of your time in:
travstats.local / dashboard
Globe
Every flight as a great-circle arc, every cruise as a sea route — all domains on one globe.
travstats.local / stats
Statistics
A tab per domain and one for everything; each year on its own or side by side.
travstats.local / dashboard · 390 px
On the phone
The same web UI at 390 pixels wide — no separate layout, the same data.
travstats.local / cruises / …
Cruise
Every port, every sea day, the sea route on the map — and a button to correct it by hand.
travstats.local / flights / …
Flight
Every flight has a page to read it on — seat, gate, booking, aircraft, price, companions.
Real screenshots from TravStats 2.6.0 — demo account, unedited. They show the German interface; the app is available in English too.
Why TravStats
Your travel history deserves more than a spreadsheet.
Cruises — every port of call
Flights are just the start. Import a cruise from email or PDF: the ship, every port, every sea day — and the flights of a fly & cruise trip along with it. The sea route is computed, and you can correct it by hand.
Your memories, on your server
TravStats lives in a Docker container on your own hardware. No ads. No analytics. No terms of service that change next week.
Numbers that tell your story
How many miles? How many countries? Most-flown airline? TravStats answers questions you didn't think to ask about your own travel history.
Bring your history with you
Drop your Flightradar24 export, an OpenFlights CSV, or any per-flight spreadsheet. TravStats maps the columns, shows you a preview, and imports — in seconds, not an evening.
Lodging
Hotels are a domain of their own.
Stays are kept like flights and cruises: a house with its chain, address and pin on the map, and under it every stay with room, board, per-category ratings, price, loyalty programme and the trip it belongs to. Photos of the building, the lobby or the view hang off the hotel and survive every stay.
- A statistics chapter of its own. What a night cost — by year, country, chain and board, with the median taken over nights rather than bookings. Where the nights were, when they were, the longest unbroken run away from home. And a travel account that splits every year into hotel, ship, aircraft and home, naming the days it cannot account for.
- Confirmations are read for you. Booking.com mails go through a deterministic template — measured against 95 real confirmations, it finds the stay in 93 and the price in all 93. Anything the template does not recognise takes the same path a flight does, through Ollama; a photographed hotel bill is a document too.
- A stay counts once it is over. A bookmarked house is not a visit and a booking for next month is not a night slept — both are reported separately, never folded into a total. A hotel you can no longer date may carry only a month, only a year, or no date at all, and says which.
travstats.local / dashboard / lodging
The lodging tab before the first hotel is in
A fresh instance lands on a starting point, not an empty map: add a hotel, or import a booking email, a PDF or a CSV list. The demo account has no stays, which is why the map is empty here. German interface shown; the app is available in English too.
Countries
Countries you can prove.
A country counts by what proves you were there, not by where a flight touched down. The old number was too high and too low at once: a four-hour connection counted as a visit, while a country reached by car and slept in for a week did not exist at all. Every country now carries its strongest evidence.
-
Slept
A completed stay, a house on record, a port call over a night — or arrival and departure on different local days.
-
Visited
A same-day stay or a recorded place. A day trip is not a connection: MUC–FCO–FRA is a day in Rome.
-
Transited
Driven through, read from the location history of a Dawarich connection. The rung appears only once an account has location history.
-
Connection
Changed planes and nothing else. Left out of the headline by default — but greyed in the list, never hidden, because flights are recorded incompletely.
How strictly countries are counted is a setting: an instance default that every account may override. The choice is one of the rungs — there is deliberately no hours threshold, because six and twelve hours returned the same countries on a real account. Data that contradicts itself — an address in a different country than the stored one, a check-out before its check-in — lands as a question in the inbox. Nothing is corrected silently, and no flag changes a number by itself.
travstats.local / passport
Beta
The passport — behind the beta switch
Every counted country names its rung and the records behind it; expanding a row lists the flights, cruises, places and houses with a link each. The counting rule applies to everyone — only this page is beta. German interface shown; the app is available in English too.
travstats.local / inbox
The inbox
Open questions about your data and proposed flight updates in one place. Each question states both values and marks neither as correct. Always in the menu; the badge alone says whether anything waits.
Money
Any currency, an honest total.
A price may be recorded in any of the 155 ISO-4217 currencies — the one you actually paid in. Conversion asks the European Central Bank first, authoritative and self-hostable, back to 1999; for the currencies the ECB does not publish, a free, keyless dataset that you as the operator can switch off entirely.
Where no source has a rate, the amount stays in its own currency, is marked "no rate", counts towards no total — and the total says how many entries it left out. You may enter a rate yourself; it is always shown as yours, never as an official one. Cruise money is reported per currency and never summed. 300 USD and 300 EUR no longer become "600 €" anywhere.
Money & currencies in the user guide →Example · hotel spend 2025
€4,812
from 11 stays — 2 without a rate, not included
- Lisbon · 4 nights €612.00
- Chicago · 3 nights 741 USD ≈ €684.10
- Ulaanbaatar · 2 nights 380,000 MNT no rate
- Bangkok · 5 nights 18,900 THB ≈ €497.30 · your rate
Illustration with made-up numbers. The wording — "no rate", "your rate", "not included" — is the app's.
travstats.local / trips / …
A trip that holds it all together
Flights, cruises, stays and places hang off a trip; it counts countries, travellers and the total price. The Tours tab and the AI summary are visible on this demo account because its beta switch is on. German interface shown; the app is available in English too.
Import & export
Spreadsheet in, spreadsheet out.
The whole logbook exports to one spreadsheet — a sheet per table: flights, cruises and their stops, houses and their stays, places and their visits — and comes back. Column A carries the id: a row that returns with one updates the record it names; a row without one is created. Airports travel as IATA codes, because a code is what you can type and check.
- A preview before anything is written. The import shows per sheet what it would change and asks what to do with what is already there: add only, merge, or replace contents — the only mode that can lose data, which is why it takes a full backup first and makes you confirm the number of entries that would disappear.
- Every import leaves a trace. Flights, cruises and stays know which document and which run they came from. The same document read twice adds nothing, and a whole run can be undone as one batch.
- Your history comes along. A Flightradar24 export, an OpenFlights CSV, any per-flight spreadsheet, a saved Google Maps list — the columns are recognised, questionable rows are shown first, and a row that is not yours is refused rather than applied.
Security
Two factors, or no password at all.
A travel logbook knows when you are not at home. Since 2.6.0 you can lock your account accordingly.
Second factor
TOTP from any authenticator app, with single-use recovery codes. The second factor is asked before a forced password change, never after — a test pins the order.
Passkeys
A passkey replaces the password entirely and counts as the second factor at the same time, because it proves possession plus a local gesture. Sign-in asks for no name, so your password manager can offer the key itself. An administrator can reset a locked-out second factor.
Content Security Policy
The page carries a CSP; scripts come only from your instance. The emoji database behind the list-symbol picker is served by your instance too, not by a content network — so it works on an installation with no way out to the internet.
Nothing in a shared cache
Every API response is Cache-Control: no-store by default, because a shared cache was observed serving one signed-in user's response to another. The session lives in an HttpOnly cookie, never in local storage.
Beta
What sits behind the switch.
Unfinished areas sit behind a switch in the admin settings. Off is the default; turn it on to test. The admin panel lists what the switch turns on — read from the same registry the app itself checks, so it cannot claim something the build does not do. Each entry says why it is still hidden and what brings it back.
-
Places
A domain of its own with lists you build yourself, curated checklists — the wonders of the world, the UNESCO World Heritage List with 1,247 sites, national parks, museum warships — and the import of saved Google Maps lists. The routes are live for the API and the Companion; the web panel waits for the rest of the domain.
-
Passport
Stamps, a continent band and the country table with the evidence per country. Complete and agreeing with the statistics page, but it landed in the middle of a release candidate — so it sits here until it has had a release review.
-
Tours
A trip walked, driven, cycled or taken by ferry — sections with their own line on the map and a route editor worked with the mouse. Works end to end; the owner ruled it unfinished.
-
Companion app
TravStats Companion is in testing. Pairing a phone — the Devices section where a claim code is minted — sits behind the switch. No store listing, no date.
-
Dawarich
The connection to a Dawarich instance supplies recorded tracks for tours and the "transited" rung. Coordinates live only for the length of one run; what is stored is the day, the country and a count of fixes.
-
Per-domain colours, AI summary
A colour of your own per domain instead of the brand's — open is whether an instance may repaint its own domains. And the AI summary of a trip, waiting for a finished Trips page.
Personal world records
The numbers your inbox has been quietly tracking.
Every TravStats user lands here eventually — surprised by their own travel history. The figures below are illustrative, but the categories are real.
270+ quiet little brags
Travel rewarded — even when nobody's looking.
Every flight, every cruise, every hotel night and every place you log unlocks more than a line in a database. TravStats hands out 270+ achievements across eight categories — for the long-haulers, the hotel-chain collectors, the country collectors and the lovers of odd coincidences: Friday the 13th, a palindrome date, a 777 flown on a 777. A badge is dated only on a genuine unlock, and one earned stays earned.
- Explorer
- Distance
- Collector
- Elite
- Special
- Planner
- Survivor
- Curiosities
Globetrotter
EarnedTouch down in 25 different countries.
Long Haul
EarnedSurvive a single flight 12 hours or longer.
Captain's Log
EarnedSail your first ship.
Round the World
LockedCover the Earth's circumference — 40,075 km logged. 14,206 km to go
Brand Explorer
LockedStay with three different hotel chains. 1 of 3
City Stroller
LockedVisit places in five different cities. Places are a beta domain
+ 270 more — from Equator Crosser and Antimeridian via Not Picky (three kinds of lodging) to Fleet Visit (ten museum warships). You unlock them as you go; TravStats backfills them retroactively when you import old flights, cruises or stays.
travstats.local / achievements
The achievements page
Filtered by domain, category and tier; every badge shows its progress. The demo account stands at 83. German interface shown; the app is available in English too.
Plays well with your stack
Runs where your other services run.
A single Docker image and a Postgres container. If you can run containers, you can run TravStats.
- Docker
- Proxmox / LXC
- Unraid
- TrueNAS
- Synology
- CasaOS
- Cloudflare Tunnel
Or any Linux box with Docker. The wiki has setup notes for each platform.
- ~10 minute setup
- Runs on a Raspberry Pi 4 or any NAS
- No cloud account, ever
Ready to start your logbook?
Set up takes about ten minutes. The wiki walks you through every step.
Frequently asked
The questions every self-hoster asks first.
Is any of my data sent anywhere?
Nothing without your say-so. TravStats reads bookings, stores data and renders maps on the server you run it on. No cloud account, no analytics; the anonymous usage statistic is opt-in and can be switched off. Three things go out by default: map tiles from OpenStreetMap-compatible tile servers (self-hostable), airline logos from a public logo service that learns only the airline code (offline, the logo is simply missing), and a request to GitHub every six hours asking whether a new version exists (fails silently offline). Optional, and only when configured: exchange rates from the European Central Bank and a free rate dataset for the currencies the ECB does not publish (can be switched off); geocoding, when you let an address be derived from a pin; flight-data APIs, when you enter keys; and Ollama, when it runs on another machine.
Can I run TravStats offline?
Yes. With a self-hosted tile server (or pre-cached map tiles) and no optional services configured, TravStats depends on no external service. The map and globe work air-gapped; amounts in a foreign currency then stay in their own currency and are marked "no rate" rather than guessed.
What happens if TravStats the project is abandoned?
Your data lives in a Postgres database in a Docker volume on hardware you own. Nothing about that changes if the project goes quiet. The schema is documented; a full backup and the spreadsheet export put every flight, cruise and stay into a portable format any time.
Do I need a public domain or static IP?
No. TravStats is happiest at http://travstats.lan:3010 on your local network. If you want HTTPS or remote access, a Cloudflare Tunnel or Tailscale link is the friendliest option — both work without exposing ports.
How much disk space does this use after years of flights?
Little. A flight record is a few kB; even thousands of flights stay well under 100 MB of database. The Docker image itself is around 200 MB. Only the photos you upload to trips, hotels or places come on top, as files in the data volume — as large as you make them.
Can I import from FlightDiary, OpenFlights, or a CSV?
Yes. TravStats ships three dedicated importers: a Flightradar24 importer that takes the unmodified my.flightradar24.com CSV export, a universal CSV mapping wizard that auto-detects column headers (OpenFlights, FlightDiary, custom spreadsheets) and shows a preview before commit, plus the spreadsheet export of the whole logbook, which comes back in. Every import can be taken back as a whole. Details in the User Guide → Import & Export and under Spreadsheet; FlightDiary column mapping is on the comparison page.
Is there an iOS or Android app?
A companion app, TravStats Companion, is in testing. Pairing a phone with your instance sits behind the beta switch, which is off by default; there is no store listing. The web UI is fully responsive and works well on a phone; a home-screen icon makes it feel native.
Documentation
Everything you need, in the wiki.
From your first docker compose up
to the API — the docs are part of the project. Open source,
versioned, no tracking.
-
Getting Started
Installation, first-time setup and the initial login.
-
User Guide
Flights, cruises, hotels, countries, maps, statistics and achievements.
-
Imports & Parsers
Email parser, boarding-pass OCR and custom templates.
-
External Services
Optional services for flight data, OCR, mail and location history.
-
API & Automation
REST API and personal access tokens for scripts.
-
Operations
Backups, database, reverse proxy and admin panel.
-
Comparisons
How does TravStats differ from other tools?
-
Troubleshooting
When something breaks — common issues and how to fix them.
Full overview in the wiki — searchable, with sidebar and full-text search.