.env.example

# =============================================================================
# Red Alert Monitoring Stack — Environment Variables
# =============================================================================
# Copy this file to .env and fill in your values:
#   cp .env.example .env
#
# Variables marked [REQUIRED] must be set. Others have sensible defaults.
# =============================================================================

# -- Your Alerting Area [REQUIRED] -------------------------------------------
# Your local area name as it appears in Pikud HaOref alerts (Hebrew).
# This is used across the entire stack:
#   - Actuator: triggers direct-threat response (red lights + shelter TTS)
#   - Geodash: highlights your area on the map
#   - Telegram Bot: includes local context in AI sitreps
#   - Prompt Runner: auto-generates immediate intel on local alerts
#   - MCP Server: provides area context to AI agents
# Example: ירושלים - דרום
ALERT_AREA=

# -- Service Ports (all optional, shown with defaults) -----------------------
# Override any port to avoid conflicts with existing services on your host.
# OREF_PROXY_PORT=8764
# GEODASH_PORT=8083
# INFLUXDB_PORT=8086
# ACTUATOR_PORT=8782
# TELEGRAM_BOT_PORT=8781
# RSS_CACHE_PORT=8785
# MCP_SERVER_PORT=8786
# PROMPT_RUNNER_PORT=8787
# MANAGEMENT_UI_PORT=8888

# -- Oref Alert Proxy --------------------------------------------------------
# No configuration needed — polls Pikud HaOref automatically.
# Must run from an Israeli IP address.

# -- InfluxDB (Geodash time-series storage) ----------------------------------
INFLUXDB_URL=http://influxdb:8086
INFLUXDB_ORG=redalert
INFLUXDB_BUCKET=alerts
INFLUXDB_TOKEN=redalert-dev-token
# INFLUXDB_ADMIN_USER=admin
# INFLUXDB_ADMIN_PASSWORD=redalert-admin

# -- Pushover Notifier [REQUIRED for push notifications] ---------------------
# Get these from https://pushover.net/
PUSHOVER_API_TOKEN=
PUSHOVER_USER_KEY=

# Alert thresholds (comma-separated area counts that trigger a push)
# PUSHOVER_THRESHOLDS=50,100,200,500,1000

# -- Telegram Bot [REQUIRED for Telegram integration] ------------------------
# Create a bot via @BotFather on Telegram
TELEGRAM_BOT_TOKEN=

# -- AI / LLM Configuration --------------------------------------------------
# OpenRouter API key — used by Telegram bot (sitrep), Prompt Runner
# Get one from https://openrouter.ai/
OPENROUTER_API_KEY=

# Groq API key — used by Prompt Runner for fast immediate intelligence
# Get one from https://console.groq.com/
# GROQ_API_KEY=

# OpenAI API key for generating TTS audio files (one-time setup)
# OPENAI_API_KEY=

# -- Home Assistant (Actuator HA Bridge) [REQUIRED for actuation] -------------
# The actuator sets an input_select entity in HA to reflect alert state.
# HA automations then handle lights, sirens, TTS, etc.
# See ha/ directory for setup instructions and example automations.
HASS_HOST=
HASS_TOKEN=
# HASS_ENTITY=input_select.red_alert_state

# -- Snapcast (for management UI client listing, optional) --------------------
# SNAPCAST_SERVER=10.0.0.4
# SNAPCAST_PORT=1780

# -- Mosquitto MQTT Broker (only used in compose/with-broker.yml) -------------
# Default config works out of the box. Customize if needed:
# MQTT_EXTERNAL_PORT=1883

# -- RSS Feeds ----------------------------------------------------------------
# Up to 10 feeds, numbered 1-10. Defaults to Times of Israel + JNS if unset.
RSS_FEED_1_URL=https://www.timesofisrael.com/feed/
RSS_FEED_1_NAME=Times of Israel
RSS_FEED_2_URL=https://www.jns.org/feed/
RSS_FEED_2_NAME=JNS
# RSS_FEED_3_URL=
# RSS_FEED_3_NAME=

# RSS poll interval in seconds (default: 300 = 5 minutes)
# RSS_POLL_INTERVAL=300

# -- Home Assistant MCP --------------------------------------------------------
# For .mcp.json — connect AI agents to your Home Assistant instance
# HA_MCP_URL=http://10.0.0.4:8123/mcp
# HA_ACCESS_TOKEN=

# -- Management UI ------------------------------------------------------------
# STACK_NAME=Red Alert Monitoring Stack
# GEODASH_EXTERNAL_URL=http://localhost:8083