# TravStats

TravStats is a self-hosted cloud app. Self-hosted travel logbook for small households and groups (1–10 users). It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1904/travstats

## Description

Self-hosted travel logbook for small households and groups (1–10 users). It's a logbook, not a live tracker — you record trips manually, scan a boarding pass, or import an email/PDF; flights now, cruises in v2, hotels and POI on the roadmap. Visualise routes on interactive 2D/3D maps, collect 58 achievements, scan boarding passes (QR/barcode/OCR), import from email and PDF via an optional local Ollama LLM. Includes automated database backups with retention, optional WebDAV off-site sync, and encrypted API-key storage.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

59/100 (Fair), based on 4 of 4 factors.
- Maintained: 100 (last commit 10 days ago)
- Popular: 35 (53 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 20 (8 GB minimum RAM, runs on ARM)

## Links

- Official website: https://travstats.de
- Docker Hub: https://hub.docker.com/r/abrechen2/travstats
- GitHub: https://github.com/Abrechen2/TravStats
- Documentation: https://travstats.de/docs/
- Unraid: https://ca.unraid.net/apps/travstats-02ftqmj1g02bin?q=TravStats

## Common questions

### What companion database template should I install before starting TravStats?

Install the travstats-db template from the same repository first. It is pre-configured with the database, user, and published port, so only the password needs to be filled in.

### Is user registration open by default?

No, it is invite-only by default. You can toggle public registration from the admin UI.

### Can I import existing flight data from a spreadsheet?

Yes, Excel/CSV round-trip import is supported. Rows containing an id update existing flights.

### Can TravStats parse confirmation emails with a local model?

Email import can use an optional local Ollama LLM. It supports plain text, HTML, Outlook .msg, and .eml.

### Can external tools access TravStats data?

It exposes a public REST API with Personal Access Tokens. The tokens have read, write, and admin scopes.

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