Documentation
Getting Started
Documentation Index Installation Details Quickstart
Architecture
Alert Geometry Coverage Data Flow Sequences Design Standards Display System Architecture Eas Decoding Summary Eas Monitor V3 Architecture Sdr Service Architecture System Architecture Theory Of Operation
Development
Agents Certification Reliability Plan Component Library Contributing Fcc Part11 Compliance Matrix Javascript Api Releasing Sdr Frequency Validation User Interface Guide
Hardware
Alpha Led Guide Argon40 Zigbee Setup Gpio Guide Gps Hat Setup Hwsetup Helper Neopixel Led Control Sdr Setup Serial To Ethernet Adapters Vfd Display Setup Waveshare Rs232 Wifi Setup
Guides
Alert Signals Analytics And Reporting Api Key Management Application Settings Audio Monitoring Audit Log Review Database Backups Disk Space Cleanup Eas Config Tool Eas Test Signal Pipeline Hardware Quickstart Health Monitoring Help Https Setup Icecast Streaming Setup Ipaws Feed Integration Local Authorities Local Mail Server Manual Eas Events Mfa Totp Setup Notifications One Button Upgrade Setup Instructions Smart Setup Ssl Web Ui Guide Tailscale Setup Tts Normalization
Troubleshooting
Audio Sdr Fix Tool Firewall Requirements Polling Not Working Sdr Master Troubleshooting Guide Troubleshooting 504 Timeout Tts Troubleshooting
Security
Audit Log Integrity Security
Reference
About Alpha M Protocol Changelog Dependency Attribution Diagrams Ecig Cap To Eas Implementation Guide V1 0 Fips Data Sources Mdc1200 Nrsc4B Same Standard Nws Alert Parameters Nws Zone Catalog Ohio Eas Documentation Overview Protocols Overview Rbds Standard Repository Statistics Sage Endec Same Vtec Event Linking
Policies
Privacy Policy Sms Messaging Terms Of Use Trademark Policy

EAS Station™ Setup Instructions

Quick Start

Installer (Recommended)

The interactive installer collects all required configuration up front and writes /opt/eas-station/.env for you:

# 1. Clone the repository
git clone https://github.com/KR8MER/eas-station.git
cd eas-station

# 2. Run the interactive installer
sudo bash install.sh

When the installer finishes, all services are running. Open https://your-server-ip and log in with the administrator account you created during installation.

Setup Wizard (Fine-Tuning)

After installation, the web-based setup wizard at https://your-server/setup lets you review and adjust configuration:

  1. Navigate to: https://your-server/setup
  2. Complete or adjust the configuration using the web interface
  3. After saving, restart the affected services:
sudo systemctl restart eas-station-web eas-station-poller

Setup Wizard Features

The web-based setup wizard provides:

Core Configuration

  • SECRET_KEY - One-click generation of secure 64-character token
  • Database Connection - PostgreSQL host, port, credentials
  • Timezone - Dropdown selection of US timezones
  • Location - State code dropdown, county name

EAS Broadcast Settings

  • EAS Originator - Dropdown of FCC-authorized codes (WXR, EAS, CIV, PEP)
  • Station ID - Validated to 8 characters, no dashes
  • FIPS Codes - Authorized county codes for manual broadcasts
  • Zone Codes - Auto-derive from FIPS codes with one click

Audio & TTS

  • Audio Ingest - Enable/disable SDR and ALSA sources
  • TTS Provider - Dropdown selection (pyttsx3, Azure, Azure OpenAI)

Hardware Integration

  • LED Sign - IP address configuration
  • VFD Display - Serial port configuration

Troubleshooting

Configuration Not Persisting

If changes in the setup wizard don't persist after restarting:

  1. Verify .env is a file, not a directory:

    ls -la .env
# Should show: -rw-r--r-- (file), not drwxr-xr-x (directory)

  2. Verify the application user can write to it:

    ls -la /opt/eas-station/.env
sudo -u eas-station test -w /opt/eas-station/.env && echo writable

  3. After saving configuration, restart the services:

    sudo systemctl restart eas-station-web eas-station-poller

Manual Configuration (Advanced)

If you prefer to configure manually instead of using the web wizard:

# 1. Copy the example file
cp .env.example .env

# 2. Generate a secret key
python3 -c "import secrets; print(secrets.token_hex(32))"

# 3. Edit .env with your values
nano .env

# 4. Restart the services
sudo systemctl restart eas-station-web eas-station-poller

After Configuration

Once configured, the .env file will contain your settings. To modify:

  1. Using the Setup Wizard (Recommended):

  2. Manually Editing .env:

    • Edit the file: nano .env

Auto-Derive Zone Codes

The setup wizard can automatically derive NWS zone codes from FIPS county codes:

  1. Enter FIPS codes in "Authorized FIPS Codes" field (e.g., 039001,039003)
  2. Click "Auto-Derive" button next to "Default Zone Codes"
  3. Zone codes will be populated automatically (e.g., OHZ001,OHC001)

This uses the existing county-to-zone mapping logic to save you from manual lookup.

Validation Features

The setup wizard validates your input:

  • SECRET_KEY: Minimum 32 characters
  • Station ID (configured at the Broadcast admin tab, persisted in eas_settings.station_id): Maximum 8 characters, no dashes
  • DEFAULT_STATE_CODE: Must be valid 2-letter state abbreviation
  • Timezone: Must be valid IANA timezone
  • Port Numbers: Must be 1-65535

Clear error messages guide you to correct any issues.

Getting Help

Back to Documentation Index

This document is served from docs/guides/SETUP_INSTRUCTIONS.md in the EAS Station™ installation.