AirTrail

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

  • Other
  • Productivity
  • Tools & Utilities
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

  • 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

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