π EAS Station Documentation
Welcome! This is your complete guide to the EAS Station emergency alert system.> β οΈ IMPORTANT: This software is experimental and for laboratory use only. Not FCC-certified for production emergency alerting.
π Getting Started
Quick Start Path:- Installation - One command to get running
- Setup Wizard - First-run configuration
- User Guide - Daily operations
π Documentation by Role
π― For Operators
Daily operations and monitoring| Guide | What You'll Learn |
|---|---|
| User Guide | Dashboard, alerts, monitoring |
| Setup Instructions | First-time configuration |
| HTTPS Setup | Secure access configuration |
π§ For Administrators
Deployment, security, and maintenance| Guide | What You'll Learn |
|---|---|
| Portainer Deployment | Complete deployment guide |
| SDR Setup | Radio receiver configuration |
| Hardware Build | Raspberry Pi setup |
| Database Troubleshooting | PostgreSQL issues |
π» For Developers
Architecture, APIs, and contributing| Guide | What You'll Learn |
|---|---|
| Developer Guidelines | Code standards, architecture, testing |
| Frontend Documentation | UI components, theming |
| JavaScript API | REST API reference |
| Contributing | How to contribute |
πΊοΈ System Overview
Architecture
EAS Station integrates multiple alert sources (NOAA Weather, IPAWS Federal) and processes them through a sophisticated pipeline that includes:
- π Multi-source alert aggregation
- π» FCC-compliant SAME encoding
- πΊοΈ PostGIS spatial filtering
- π‘ SDR broadcast verification
- π Built-in HTTPS with Let's Encrypt
- β‘ GPIO relay and LED sign control
π Documentation Structure
docs/
βββ guides/ β Essential operator guides (5 files)
βββ hardware/ β SDR, GPIO, Raspberry Pi setup
βββ audio/ β Audio system documentation
βββ deployment/ β Deployment and maintenance guides
βββ evaluations/ β Hardware evaluation reports
βββ troubleshooting/ β Problem-solving guides
βββ development/ β Developer documentation
βββ architecture/ β System design and theory
βββ frontend/ β Web UI documentation
βββ reference/ β Technical reference materials
βββ security/ β Security documentation
βββ roadmap/ β Future features and planning
βββ resources/ β Vendor PDFs and external docs
Complete Index - Searchable list of all documentationπ― Common Tasks
Setup & Configuration
Daily Operations
Troubleshooting
π Getting Help
- Check the documentation - Start with INDEX
- Review troubleshooting - See Common Issues
- Run diagnostics - Use built-in diagnostic tools
- Ask for help - GitHub Discussions
- Report bugs - GitHub Issues
π Project Information
| Resource | Link |
|---|---|
| About | Project Overview |
| Changelog | Version History |
| Roadmap | Future Features |
| License | AGPL v3 (Open Source) / Commercial |
Legal & Compliance
π€ Contributing
We welcome contributions! See:
Last Updated: 2025-11-25 Documentation Version: 3.0 (Reorganized Structure)Return to Main README | View Complete Index
This document is served from docs/README.md in the EAS Station installation.