skyview/debian/usr/share/doc/skyview-adsb/README.Debian

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

SkyView is a multi-source ADS-B aircraft tracker that connects to dump1090 Beast
format TCP streams and provides a web-based interface for aircraft tracking.

Configuration
------------

The main configuration file is located at:
  /etc/skyview/config.json

This file contains:
- Server configuration (port, host)
- List of dump1090 sources to connect to
- Application settings

Example configuration for multiple receivers:

```json
{
  "server": {
    "host": "",
    "port": 8080
  },
  "sources": [
    {
      "id": "site1",
      "name": "Site 1 Receiver",
      "host": "192.168.1.100",
      "port": 30005,
      "latitude": 51.4700,
      "longitude": -0.4600,
      "altitude": 50.0,
      "enabled": true
    },
    {
      "id": "site2", 
      "name": "Site 2 Receiver",
      "host": "192.168.1.101",
      "port": 30005,
      "latitude": 51.4800,
      "longitude": -0.4500,
      "altitude": 45.0,
      "enabled": true
    }
  ],
  "settings": {
    "history_limit": 1000,
    "stale_timeout": 60,
    "update_rate": 1
  }
}
```

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

SkyView runs as a systemd service. Use these commands to manage it:

  # Start the service
  sudo systemctl start skyview

  # Stop the service  
  sudo systemctl stop skyview

  # Restart the service
  sudo systemctl restart skyview

  # Enable auto-start on boot
  sudo systemctl enable skyview

  # Disable auto-start on boot
  sudo systemctl disable skyview

  # Check service status
  sudo systemctl status skyview

  # View logs
  sudo journalctl -u skyview -f

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

Once started, the web interface is available at:
  http://localhost:8080

The interface provides:
- Real-time aircraft tracking map
- Aircraft table with filtering and sorting
- Statistics dashboard
- Coverage and signal strength visualization
- 3D radar view (optional)

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

  /usr/bin/skyview              - Main executable
  /etc/skyview/config.json      - Configuration file
  /var/lib/skyview/             - Application data directory
  /var/log/skyview/             - Log files
  /lib/systemd/system/skyview.service - Systemd service file

Security
--------

SkyView runs as the unprivileged 'skyview' user for security. The service has
restricted capabilities and filesystem access.

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

1. Check service status:
   sudo systemctl status skyview

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

3. Test configuration:
   sudo -u skyview /usr/bin/skyview -config /etc/skyview/config.json

4. Check network connectivity to dump1090 sources:
   telnet <host> <port>

For more information, visit: https://github.com/skyview/skyview