Sign inSign up

k9barry/noaa-alerts-pushover

By k9barry

•Updated 10 months ago

Real-time NOAA severe weather alerts delivered via Pushover push notifications to your devices.

Image
Message queues
Content management system
0

2.0K

k9barry/noaa-alerts-pushover repository overview

⁠NOAA Alerts Pushover - Docker Image

Real-time NOAA severe weather alerts delivered via Pushover push notifications to your devices.

⁠Quick Start

# Pull the image
docker pull k9barry/noaa-alerts-pushover:latest

# Create configuration files
mkdir -p data output
wget https://raw.githubusercontent.com/k9barry/noaa-alerts-pushover/master/config.txt.example -O config.txt
wget https://raw.githubusercontent.com/k9barry/noaa-alerts-pushover/master/counties.json

# Edit config.txt with your Pushover credentials
# Edit counties.json with your monitored counties

# Run the container
docker run -d \
  --name noaa-alerts \
  -v $(pwd)/config.txt:/app/config.txt:ro \
  -v $(pwd)/counties.json:/app/counties.json:ro \
  -v $(pwd)/output:/app/output \
  -v $(pwd)/data:/app/data \
  -e RUN_MODE=scheduler \
  -e TZ=UTC \
  --restart unless-stopped \
  k9barry/noaa-alerts-pushover:latest

⁠Features

  • 🌪️ Real-time severe weather alerts from NOAA
  • 📱 Push notifications via Pushover API
  • 🗺️ Monitor multiple counties across the US
  • 🔕 Filter out unwanted alert types
  • 💾 SQLite database prevents duplicate notifications
  • 🔄 Automatic cleanup of expired alerts
  • 🛡️ Robust error handling and security

⁠Configuration

⁠Required Files
  1. config.txt - Pushover API credentials and settings
  2. counties.json - List of counties to monitor

Download templates:

⁠Environment Variables
  • RUN_MODE: Set to scheduler for continuous monitoring (recommended) or once for single run
  • TZ: Timezone for logs (default: UTC)
⁠Volumes
  • /app/config.txt - Configuration file (mount as read-only)
  • /app/counties.json - Counties list (mount as read-only)
  • /app/output - Generated HTML alert files
  • /app/data - SQLite database
⁠Scheduler Intervals

Configure check intervals in config.txt:

[schedule]
fetch_interval = 5        # Check for new alerts (minutes)
cleanup_interval = 24     # Remove expired HTML files (hours)
vacuum_interval = 168     # Database maintenance (hours/weekly)

⁠Docker Compose

Example docker-compose.yml:

services:
  noaa-alerts:
    image: k9barry/noaa-alerts-pushover:latest
    container_name: noaa-alerts-pushover
    restart: unless-stopped
    volumes:
      - ./config.txt:/app/config.txt:ro
      - ./counties.json:/app/counties.json:ro
      - ./output:/app/output
      - ./data:/app/data
    environment:
      - PYTHONUNBUFFERED=1
      - TZ=UTC
      - RUN_MODE=scheduler
    healthcheck:
      test: ["CMD", "/healthcheck.sh"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s

⁠Security

  • Container runs as non-root user noaa (UID 1000)
  • Configuration files can be mounted read-only
  • No secrets embedded in the image
  • All API calls use HTTPS
⁠Volume Permissions

The container runs as UID 1000. Ensure mounted directories are writable:

# If your user is UID 1000 (check with: id -u)
chmod 755 ./output ./data

# Otherwise, set ownership
sudo chown -R 1000:1000 ./output ./data

⁠Tags

  • latest - Latest stable release from master branch
  • v2.2.0, v2.1.0, etc. - Specific version tags
  • 2.2, 2 - Major/minor version shortcuts

⁠Requirements

  • Docker Engine 20.10+
  • Active Pushover⁠ account (for notifications)
  • Internet connection to NOAA API

⁠Usage Examples

⁠Single Run Mode

Test the setup without continuous monitoring:

docker run --rm \
  -v $(pwd)/config.txt:/app/config.txt:ro \
  -v $(pwd)/counties.json:/app/counties.json:ro \
  -v $(pwd)/output:/app/output \
  -v $(pwd)/data:/app/data \
  -e RUN_MODE=once \
  k9barry/noaa-alerts-pushover:latest
⁠Debug Mode

Enable debug logging:

docker run --rm \
  -v $(pwd)/config.txt:/app/config.txt:ro \
  -v $(pwd)/counties.json:/app/counties.json:ro \
  -v $(pwd)/output:/app/output \
  -v $(pwd)/data:/app/data \
  -e RUN_MODE=once \
  k9barry/noaa-alerts-pushover:latest \
  --debug --nopush

⁠Support and Documentation

⁠License

MIT License - See LICENSE⁠

Tag summary

Content type

Image

Digest

sha256:fb02822f0…

Size

119.8 MB

Last updated

10 months ago

docker pull k9barry/noaa-alerts-pushover