---
title: "Deploy AirTrail"
description: "Self-hosted personal flight tracker: map, stats, imports. Pinned v3.14.0"
category: "Other"
url: https://railway.com/deploy/airtrail-2
---

# Deploy AirTrail

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

**[Deploy AirTrail on Railway](https://railway.com/template/airtrail-2)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/airtrail-2/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### AirTrail https://raw.githubusercontent.com/johanohly/AirTrail/v3.14.0/docs/public/logo.png

- **Source:** https://github.com/aalfath/airtrail-railway-template
- **Health check:** /api/ping
- **Public domain:** Yes

## Documentation

# 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

* AirTrail source and releases: https://github.com/johanohly/AirTrail (v3.14.0)
* Official image: https://hub.docker.com/r/johly/airtrail
* Docs and environment variables: https://airtrail.johan.ohly.dk/docs/administration/environment-variables
* Template repo: https://github.com/aalfath/airtrail-railway-template

### 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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/airtrail-2
