SkySpy Documentation

✈️ SkySpy Documentation

Version Django React Go License

Enterprise-grade ADS-B aircraft tracking and monitoring platform

Quick Start Β· API Reference Β· Deployment


🎯 What is SkySpy?

SkySpy is a comprehensive aircraft tracking platform that processes ADS-B, ACARS, and other aviation data sources. It provides real-time visualization, safety monitoring, custom alerts, and rich analytics.

flowchart LR
    subgraph Input["πŸ“‘ Data Sources"]
        ADSB[ADS-B<br/>Receivers]
        ACARS[ACARS<br/>Decoders]
    end

    subgraph Core["βš™οΈ SkySpy"]
        API[Django API]
        WS[Socket.IO]
    end

    subgraph Output["πŸ–₯️ Clients"]
        WEB[Web Dashboard]
        CLI[Go CLI]
        EXT[Your App]
    end

    ADSB --> API
    ACARS --> API
    API --> WS
    WS --> WEB
    WS --> CLI
    API --> EXT

πŸ“š Documentation Index

πŸš€ Getting Started

πŸ“˜

New to SkySpy? Start here!

DocumentDescription
🏁Quick StartGet running in 5 minutes with Docker
πŸ—οΈOverviewArchitecture, tech stack, core concepts
βš™οΈConfigurationComplete environment and settings reference

πŸ” Core Features

DocumentDescription
πŸ”‘AuthenticationJWT, API keys, OIDC, permissions
πŸ—„οΈDatabaseModels, schema, relationships, migrations

πŸ”Œ API Reference

πŸ’‘

Building an integration? These docs are for you.

DocumentDescription
🌐REST APIComplete HTTP endpoint reference
⚑Socket.IO APIReal-time streaming, namespaces, events

🧩 Components

DocumentDescription
🐹Go ServicesCLI application, radar display
βš›οΈFrontendReact web application architecture
⏰Background TasksCelery workers, scheduled jobs

✨ Features

DocumentDescription
πŸ—ΊοΈMap & AviationMap layers, weather, aviation data
🚨Safety & AlertsSafety monitoring, alert rules
πŸ“‘ACARSACARS/VDL2 message integration
🎯Cannonball ModeMobile proximity detection
πŸ“ŠStatisticsAnalytics, gamification, exports

πŸ› οΈ Operations

DocumentDescription
πŸš€DeploymentDocker, production, Raspberry Pi
πŸ§ͺTestingRunning and writing tests

πŸ‘¨β€πŸ’» Development

DocumentDescription
🀝ContributingDev setup, code style, PR process
πŸ”§TroubleshootingCommon issues, debugging, FAQ

πŸƒ Quick Commands

# 🐳 Start with Docker
docker compose up -d

# πŸ“Š View logs
docker compose logs -f api

# πŸ§ͺ Run tests
docker compose run --rm api pytest

# πŸ”„ Update
git pull && docker compose up -d --build

πŸ”— Quick Links

ResourceDescription
πŸ“–Swagger UIInteractive API explorer
πŸ“‹ReDocAPI reference documentation
πŸ–₯️AdminDjango admin interface
❀️HealthSystem health check

πŸ’¬ Support

⚠️

Having issues? Check the Troubleshooting Guide first!


SkySpy v0.2.0 · Built with ❀️ for the aviation community

Documentation generated with comprehensive codebase analysis