SkyView for Debian
==================

SkyView is a multi-source ADS-B aircraft tracker with comprehensive database integration
for enhanced aviation data and callsign lookup functionality.

Post-Installation Setup
-----------------------

After installation, SkyView automatically:
- Creates skyview-adsb user and required directories
- Initializes SQLite database with aviation data sources
- Configures systemd services

Required Configuration
----------------------

Edit the main configuration file:
  /etc/skyview-adsb/config.json

Update at minimum:
- Source coordinates (latitude/longitude) for your ADS-B receiver locations
- Origin coordinates for map center
- ADS-B receiver connection details (host/port)

See /usr/share/doc/skyview-adsb/CONFIGURATION.md for complete configuration options.

Service Management
------------------

SkyView includes two systemd services:

Main Service:
  sudo systemctl start skyview-adsb
  sudo systemctl enable skyview-adsb    # Auto-start on boot
  sudo systemctl status skyview-adsb
  sudo journalctl -u skyview-adsb -f    # View logs

Database Update Service (runs weekly):
  sudo systemctl start skyview-database-update      # Manual update
  sudo systemctl enable --now skyview-database-update.timer  # Enable weekly updates
  sudo systemctl status skyview-database-update.timer

Database Management
-------------------

View database status:
  skyview-data -config /etc/skyview-adsb/config.json status

Update aviation databases:
  skyview-data -config /etc/skyview-adsb/config.json update

Optimize database storage:
  skyview-data -config /etc/skyview-adsb/config.json optimize

List available data sources:
  skyview-data -config /etc/skyview-adsb/config.json list

Web Interface
-------------

Access the web interface at: http://localhost:8080

Features include:
- Real-time aircraft tracking map
- Enhanced callsign information with airline details
- Database status monitoring at /database
- Aircraft history and trail visualization
- Coverage and signal strength analysis
- 3D radar view

External Data Sources
---------------------

SkyView includes three aviation databases:
- OpenFlights Airlines (~6,162 airlines)
- OpenFlights Airports (~7,698 airports)  
- OurAirports (~83,557 airports worldwide)

Privacy Mode: Set "privacy_mode": true in config to disable external data loading.

Files and Directories
---------------------

Executables:
  /usr/bin/skyview              - Main ADS-B tracker service
  /usr/bin/skyview-data         - Database management utility
  /usr/bin/beast-dump           - Raw ADS-B data analysis tool

Configuration:
  /etc/skyview-adsb/config.json - Main configuration file

Data:
  /var/lib/skyview-adsb/        - Application and database directory
  /var/log/skyview-adsb/        - Log files

Services:
  /lib/systemd/system/skyview-adsb.service                  - Main service
  /lib/systemd/system/skyview-database-update.service       - Database updater
  /lib/systemd/system/skyview-database-update.timer         - Weekly update timer

Documentation:
  /usr/share/doc/skyview-adsb/CONFIGURATION.md - Complete configuration guide
  /usr/share/doc/skyview-adsb/DATABASE.md      - Database schema reference

Security
--------

SkyView runs as the unprivileged 'skyview-adsb' user with comprehensive systemd security hardening:
- NoNewPrivileges, ProtectSystem=strict, ProtectHome=true
- Private temporary directories and device access restrictions
- Restricted namespaces and capabilities

Troubleshooting
---------------

1. Check main service status:
   sudo systemctl status skyview-adsb

2. View recent logs:
   sudo journalctl -u skyview-adsb --no-pager -l

3. Test database connectivity:
   skyview-data -config /etc/skyview-adsb/config.json status

4. Manual database update:
   sudo -u skyview-adsb skyview-data -config /etc/skyview-adsb/config.json update

5. Check ADS-B source connectivity:
   telnet <receiver_host> <receiver_port>

6. View database information in web interface:
   http://localhost:8080/database

For complete documentation, see:
- /usr/share/doc/skyview-adsb/CONFIGURATION.md
- /usr/share/doc/skyview-adsb/DATABASE.md
- man skyview(1), man skyview-data(1), man beast-dump(1)

Project repository: https://kode.naiv.no/olemd/skyview