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
Ole-Morten Duesund
779384b748