Manual Installation

Get the source

Clone the repository and check out the latest release, so you run a tested version rather than the development branch:

git clone https://github.com/JohanOhly/AirTrail.git
cd AirTrail
git checkout "$(git describe --tags --abbrev=0)"

Install dependencies

bun install

Configure

cp .env.example .env

In .env:

• Set ORIGIN to the exact URL you will open AirTrail at.
• Set DB_URL to your database, for example postgres://airtrail:secret@localhost:5432/airtrail.
• Set UPLOAD_LOCATION to an absolute path the service user can write to, such as /var/lib/airtrail/uploads.
• The DB_PASSWORD, DB_DATABASE_NAME and DB_USERNAME variables only configure the Docker database container and can be removed.

See Environment variables for everything else.

Add the airport map layer (optional)

The detailed airport layer on the map (runways, taxiways and terminals) comes from a 200 MB data file that is not in the repository. Without it, AirTrail works normally but shows no airport detail on the map. If Docker is available on any machine, copy the file out of its image and place it in static/ before building:

id=$(docker create johly/airtrail-airport-overlay:latest noop)
docker cp "$id":/airport-overlay.pmtiles static/airport-overlay.pmtiles
docker rm "$id"

Build and migrate

bun run build
bun run db:migrate-deploy

Start the server

node does not read .env by itself, so pass it explicitly:

node --env-file=.env build

AirTrail listens on port 3000. Open the URL from ORIGIN and follow the post-installation steps.