# AirTrail

AirTrail is a self-hosted web app for tracking personal flights, importing travel history, visualizing routes on an interactive world map, and sharing statistics with multiple users. It is open source and self-hosted, installable on Docker Hub, Proxmox and Umbrel.

Canonical page: https://ourlocalhost.com/app/3654/airtrail

## Description

AirTrail is a self-hosted web app for tracking personal flights, importing travel history, visualizing routes on an interactive world map, and sharing statistics with multiple users.

## Platform availability

Available on 3 of 10 platforms: Umbrel, Proxmox, Any server.

## Health score

82/100 (Excellent), based on 5 of 5 factors.
- Maintained: 100 (last commit 11 days ago)
- Popular: 65 (1,717 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Light to run: 95 (512 MB minimum RAM, runs on ARM)
- Security check: 86 (no serious findings, CI, tests, OpenSSF Scorecard 7.2/10)

## Links

- Official website: http://airtrail.johan.ohly.dk/
- Docker Hub: https://hub.docker.com/r/johly/airtrail
- GitHub: https://github.com/johanohly/AirTrail
- Documentation: http://airtrail.johan.ohly.dk/docs/overview/quick-start
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=airtrail
- Umbrel: https://apps.umbrel.com/app/airtrail

## Common questions

### How do I use the one-click install script?

Run it on Linux or macOS with curl, Docker, and Docker Compose v2 installed, from the folder where you want AirTrail's files. It creates the airtrail folder, sets a random database password, asks for the ORIGIN URL, and starts a working first setup.

### What should I set in .env for a manual Docker Compose setup?

Set ORIGIN to the address you will use to visit AirTrail and change the database password in DB_URL before running docker compose up -d. Missing or wrong values can break first login or data storage.

### Why does AirTrail appear stuck during the first start?

The first start downloads airport and airline data. Run docker compose up -d and follow the progress with docker compose logs -f airtrail; use docker compose, not docker-compose, with Docker Compose v2.

### Can I import my existing flight history?

Yes, AirTrail can import flights from MyFlightRadar24, App in the Air, and JetLog.

### Does it support multiple users and OAuth?

It supports multiple users, sharing flights among them, user authentication, and integration with an OAuth provider.

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