Deploy AirTrail

Self-hosted personal flight tracker: map, stats, imports. Pinned v3.14.0

Deploy AirTrail

/var/lib/postgresql/data

/app/uploads

Deploy and Host AirTrail on Railway

AirTrail is an open-source, self-hosted personal flight tracker. It draws every flight you've taken on a world map, keeps your full flight history with seats, aircraft and notes, and turns it into statistics. It imports from other trackers, supports several users with roles, and offers OAuth sign-in and a calendar feed.

About Hosting AirTrail

AirTrail is a Node.js (SvelteKit) server backed by PostgreSQL. This template runs the official johly/airtrail image, version 3.14.0 pinned by digest, built from a public GitHub repo, plus Railway's Postgres with a generated password. Uploaded airline icons live on a volume at /app/uploads, and the database has its own volume, so data survives redeploys. Migrations run on every start. ORIGIN is set from the Railway domain, so sign-in works on the first deploy. On the first start AirTrail downloads airport and airline data, which takes about a minute. Then open the URL and create the owner account on the Welcome screen.

Common Use Cases

  • Keep a private, lifelong log of your flights on a world map
  • See statistics: distance, routes, airlines, aircraft, countries and punctuality
  • Share a flight tracker with family or friends, each with their own account
  • Move your history out of MyFlightRadar24, App in the Air, Flighty, TripIt or JetLog

Dependencies for AirTrail Hosting

  • PostgreSQL (included: Railway's Postgres service)
  • A volume for uploaded airline icons (included)

Deployment Dependencies

Implementation Details

There are no prompts at deploy time. The AirTrail service gets DB_URL=${{Postgres.DATABASE_URL}}, ORIGIN=https://${{RAILWAY_PUBLIC_DOMAIN}} and PORT=3000, and a health check on /api/ping. There is no default account: the first visitor creates the owner, so open the URL soon after deploying. The start script sets ADDRESS_HEADER=X-Real-IP, so login rate limits count each visitor separately behind Railway's proxy.

If you add a custom domain, set ORIGIN to it (for example https://flights.YOUR-DOMAIN), or sign-in fails. Optional features (OAuth, AeroDataBox lookups, basemap providers, aircraft photos) are set in the app under Settings or as variables from the AirTrail docs.

Updates: the service builds from the template repo, which pins each release by digest. When a new AirTrail version is merged there, Railway shows an update notice in your project, and you choose when to apply it. Read CHANGELOG.md and back up the database first, because migrations only run forward.

Why Deploy AirTrail on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying AirTrail on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0