AirTrail
AirTrail is a self-hosted web app for tracking personal flights, importing travel history, visualizing routes on an interactive world map, and sharing…
Platform availability
Available on 3 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel
- ZimaOS (not listed)
- Proxmox
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
82/100 Excellent
- Maintained
- 100last commit 11 days ago
- Popular
- 651,717 GitHub stars
- Easy to install
- 553 install platforms, install notes, Docker image
- Light to run
- 95512 MB minimum RAM, runs on ARM
- Security check
- 86no serious findings, CI, tests, OpenSSF Scorecard 7.2/10
Availability: platform listings confirmed today, links checked yesterday
- GitHub stars
- 1,717
- Open issues
- 17
- Last commit
- 2026-11-09
- Latest release
- v3.14.0
- License
- GPL-3.0
- Activity
- rising
Checked 5 days ago - source: GitHub (johanohly/AirTrail)
Resources & Compatibility
Minimum requirements: 512 MB RAM, 1 CPU core(s). ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Use the one-click script first Run it on Linux or macOS where curl, Docker, and Docker Compose v2 are installed, from the folder where you want AirTrail's files. It creates the airtrail folder, sets a random database password, asks for the URL to use as ORIGIN, and starts AirTrail so you get a working first setup instead of missing files. source
- Set ORIGIN and DB_PASSWORD in .env If you do the Docker Compose setup manually, edit the .env file to set ORIGIN to the address you'll use to visit AirTrail and change the database password in DB_URL before running docker compose up -d. These values control how you reach the app and how it connects to its database, so wrong or missing values can break first login or data storage. source
- First start downloads data Run docker compose up -d, then follow the first-minute airport and airline data download with docker compose logs -f airtrail so it does not look stuck. Use docker compose, not docker-compose, because Docker Compose v2 expects the new command name. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from github.com, github.com, github.com, github.com
Community
Collected 49 days ago - public community threads