A self-hostable personal flight tracker and viewer

• Features
• Installation
  • Docker
  • Manual
• Importing
  • MyFlightRadar24
  • Custom
• API
• Stack
• Other credits

• 🌍 World map view of all visited airports and trajectories of flights
• 📊 Statistics for all your flights
• 📱 Responsive design
• 👨‍💻 Sleek and intuitive UI
• ✅ Effortlessly add, edit, and delete past flights
• 💾 Ability to import from CSV, MyFlightRadar24
• 💾 Ability to export to CSV, iCal

Use the sample docker-compose.yml from the repo or make your own. Make sure to add a volume from your data path to /data, and remember that the application in the container runs on port 3000.

Note: Please make sure that the volume you are binding to the container has appropriate ownership, otherwise it won't start. To do this, you can either create the folder to be used as volume before running the container for the first time, or let docker create it first and then set its ownership manually by running sudo chown -R 1000:1000 /path/to/volume/folder (you can change 1000:1000 to whatever your user and group IDs are).

Non-stable releases: You can pull the image with the :experimental tag to gain access to the latest features which have not been thoroughly tested yet.

Supported platforms: linux/amd64, linux/arm64.

Below are some of the environment variables you can set in the Docker Compose.

1. Clone the repository and cd to it
2. Install npm dependencies and build frontend

   npm ci
   npm run build
   

3. Install pipfile dependencies with pipenv

   pip install pipenv
   pipenv install
   

4. Open the virtual shell and start the server

   pipenv shell
   (jetlog) python -m uvicorn main:app --app-dir server --host 0.0.0.0 --port 3000
   

5. All done, you can open http://localhost:3000 on your browser to view jetlog

The API has a dedicated /importing endpoint, which supports the formats described below

1. Go to MyFlightRadar24 > Settings > Export and download the CSV
2. Go to Jetlog > Settings > Import
3. Upload your CSV in the MyFlightRadar24 section and press Import
4. Check your logs for progress

This format allows you to create a custom CSV that will be imported. The CSV should have the following columns (order doesn't matter):

The importing logs should give you information about any errors.

Here's an example custom CSV:

date,distance,origin,destination,arrival_time,departure_time
2024-03-14,800,lime,eheh,11:20,10:00
2024-03-19,800,eheh,lime,18:40,16:30

1. Go to Jetlog > Settings > Import
2. Upload your CSV in the Custom CSV section and press Import
3. Check your logs for progress

You can make use of the automatically generated docs (thanks to FastAPI) by going to http://<your-ip>:<your-port>/docs.

• FastAPI
• SQLite
• React
• TailwindCSS

• Favicon
• Airports database
• react-simple-map
• World GeoJSON