.env.example

# Amber API Configuration
# Required for service-managed Amber authentication and automatic token refresh.
AMBER_USERNAME=your-username@example.com
# Password: If using special characters, wrap in single quotes
AMBER_PASSWORD='your-password'

# Auth Token - REQUIRED for all API endpoints (except health check)
# This is NOT your Amber API key - it's a local security mechanism for this wrapper.
# Generate one using: docker run --rm ghcr.io/d1scolor/amber-api-wrapper:latest python -m amber_api_wrapper generate-key
# Minimum length: 32 characters
AUTH_TOKEN=your-32-character-auth-token-here

# Optional: Read-only auth token (for dashboards/read-only apps)
# READ_ONLY_AUTH_TOKEN=your-read-only-auth-token-here

# Optional: Raw GraphQL endpoint. Disabled by default; if enabled, it still
# requires the admin AUTH_TOKEN, not READ_ONLY_AUTH_TOKEN.
# ENABLE_RAW_QUERY=false

# Optional: Scheduler timezone. Cron expressions are evaluated in this timezone.
# If unset, the app detects /etc/localtime or /etc/timezone, then falls back
# to Australia/Sydney.
# Australian timezone examples:
#   Australia/Sydney
#   Australia/Melbourne
#   Australia/Brisbane
#   Australia/Adelaide
#   Australia/Perth
#   Australia/Hobart
#   Australia/Darwin
#   Australia/Broken_Hill
#   Australia/Eucla
#   Australia/Lord_Howe
#   Australia/Lindeman
#   Australia/Currie
TZ=Australia/Sydney

# Task schedules - ALL variables starting with SCHEDULE_ are loaded automatically
# Format: SCHEDULE_<name>=<cron>|<action>|<arg1>=<val1>,<arg2>=<val2>
#
# Cron syntax: minute hour day month day_of_week
#   * * * * *    Every minute
#   0 * * * *    Every hour at minute 0
#   0 18 * * *   Every day at 6:00 PM
#   */5 * * * *  Every 5 minutes
#   0 9 * * 1-5  Weekdays at 9:00 AM
#
# Actions and arguments:
#
#   add_override
#       action=charge|discharge|preserve-charge|self-consume
#       duration_hours=0.5|1|1.5|2   (Amber API only accepts these durations)
#
#   cancel_override
#       override_id=override_id|all    (use 'all' to cancel all active overrides)
#
#   toggle_optimization
#       enabled=true|false
#
#   fetch_prices
#       (no arguments needed)
#
# Examples:
# Add sell override at 6 PM daily for 2 hours
# SCHEDULE_SELL=0 18 * * *|add_override|action=discharge,duration_hours=2
#
# Add charge override at 11 PM daily for 2 hours (preserve charge)
# SCHEDULE_CHARGE=0 23 * * *|add_override|action=preserve-charge,duration_hours=2
#
# Disable SmartShift optimization at 7 AM daily (save power during low-demand hours)
# SCHEDULE_OPTIMIZE=0 7 * * *|toggle_optimization|enabled=false

# Multiple tasks - just add more SCHEDULE_ lines:
# SCHEDULE_MORNING_CHECK=0 9 * * 1-5|fetch_prices|
# SCHEDULE_AFTERNOON_OVERRIDE=0 13 * * 1-5|add_override|action=discharge,duration_hours=2
# SCHEDULE_EVENING_CANCEL=0 19 * * *|cancel_override|override_id=all

# Optional: Custom API endpoints (defaults provided in client)
# AMBER_GRAPHQL_URL=https://backend.amber.com.au/graphql
# AMBER_COGNITO_REGION=ap-southeast-2
# AMBER_USER_POOL_ID=ap-southeast-2_vPQVymJLn
# AMBER_CLIENT_ID=11naqf0mbruts1osrjsnl2ee1