| Current Path : /home/otto/python/ |
| Current File : //home/otto/python/env.example |
# Python Mail Service Configuration # Copy this file to .env.local and modify the values for your environment # # This file contains all the configuration options for the Python applications # including mail service, server monitoring, and logging settings. # ============================================================================= # MAIL SERVER CONFIGURATION # ============================================================================= # SMTP Server Host (required) # Examples: smtp.gmail.com, smtp-mail.outlook.com, mail.yourdomain.com MAIL_SMTP_HOST=smtp.gmail.com # SMTP Server Port (required) # Common ports: 25 (no encryption), 587 (TLS), 465 (SSL) MAIL_SMTP_PORT=587 # SMTP Username (required if authentication is needed) # Usually your email address MAIL_SMTP_USERNAME=your-email@gmail.com # SMTP Password (required if authentication is needed) # For Gmail, use an App Password if 2FA is enabled MAIL_SMTP_PASSWORD=your-app-password-here # Use TLS encryption (recommended for most providers) # true = use TLS, false = no encryption MAIL_SMTP_USE_TLS=true # Use SSL encryption (alternative to TLS) # true = use SSL, false = no SSL # Note: Don't use both TLS and SSL MAIL_SMTP_USE_SSL=false # Authentication required (true for most providers) # true = login required, false = no authentication needed MAIL_SMTP_AUTH_REQUIRED=true # Default sender email address (optional) # Used when no from_email is specified in send_email() MAIL_FROM_EMAIL=noreply@yourdomain.com # Default sender name (optional) # Used when no from_email is specified in send_email() MAIL_FROM_NAME=Python Mail Service # ============================================================================= # SERVER MONITORING CONFIGURATION # ============================================================================= # Email address to send server alerts to (required) # This is where server health alerts will be sent SERVER_MONITOR_ALERT_EMAIL=server-admin@igot.africa # Disk usage threshold percentage (optional, default: 85.0) # Alert when disk is more than this percentage full SERVER_MONITOR_DISK_THRESHOLD=85.0 # Memory available threshold percentage (optional, default: 10.0) # Alert when less than this percentage of memory is available SERVER_MONITOR_MEMORY_THRESHOLD=10.0 # CPU load threshold multiplier (optional, default: 1.5) # Alert when CPU load is higher than this times the number of cores # Example: 1.5 means alert when load > 150% of available cores SERVER_MONITOR_CPU_THRESHOLD=1.5 # ============================================================================= # LOGGING CONFIGURATION (optional) # ============================================================================= # Log level (optional, default: INFO) # Options: DEBUG, INFO, WARNING, ERROR, CRITICAL LOG_LEVEL=INFO # Log file path (optional, default: python-app.log) # Relative to the python/ directory LOG_FILE=python-app.log # ============================================================================= # QUICK SETUP EXAMPLES FOR POPULAR PROVIDERS # ============================================================================= # Gmail Configuration (uncomment and modify as needed) # MAIL_SMTP_HOST=smtp.gmail.com # MAIL_SMTP_PORT=587 # MAIL_SMTP_USERNAME=your-email@gmail.com # MAIL_SMTP_PASSWORD=your-app-password # MAIL_SMTP_USE_TLS=true # MAIL_SMTP_USE_SSL=false # MAIL_SMTP_AUTH_REQUIRED=true # Outlook/Hotmail Configuration (uncomment and modify as needed) # MAIL_SMTP_HOST=smtp-mail.outlook.com # MAIL_SMTP_PORT=587 # MAIL_SMTP_USERNAME=your-email@outlook.com # MAIL_SMTP_PASSWORD=your-password # MAIL_SMTP_USE_TLS=true # MAIL_SMTP_USE_SSL=false # MAIL_SMTP_AUTH_REQUIRED=true # Yahoo Mail Configuration (uncomment and modify as needed) # MAIL_SMTP_HOST=smtp.mail.yahoo.com # MAIL_SMTP_PORT=587 # MAIL_SMTP_USERNAME=your-email@yahoo.com # MAIL_SMTP_PASSWORD=your-app-password # MAIL_SMTP_USE_TLS=true # MAIL_SMTP_USE_SSL=false # MAIL_SMTP_AUTH_REQUIRED=true # Custom SMTP Server (uncomment and modify as needed) # MAIL_SMTP_HOST=mail.yourdomain.com # MAIL_SMTP_PORT=25 # MAIL_SMTP_USERNAME= # MAIL_SMTP_PASSWORD= # MAIL_SMTP_USE_TLS=false # MAIL_SMTP_USE_SSL=false # MAIL_SMTP_AUTH_REQUIRED=false # ============================================================================= # IMPORTANT NOTES # ============================================================================= # 1. Copy this file to .env.local and modify the values # 2. Never commit .env.local to version control (it contains passwords) # 3. For Gmail, you may need to: # - Enable "Less secure app access" OR # - Use an App Password if 2FA is enabled # 4. Test your configuration with: python -m app.services.mail # 5. The server monitoring will only send emails when there are alerts # 6. All thresholds are configurable via environment variables # ============================================================================= # CONCISE .env FILE TEMPLATE # ============================================================================= # Copy the variables below to create a minimal .env file # Remove the # at the beginning of each line and set your values #MAIL_SMTP_HOST=smtp.gmail.com #MAIL_SMTP_PORT=587 #MAIL_SMTP_USERNAME=your-email@gmail.com #MAIL_SMTP_PASSWORD=your-app-password-here #MAIL_SMTP_USE_TLS=true #MAIL_SMTP_USE_SSL=false #MAIL_SMTP_AUTH_REQUIRED=true #MAIL_FROM_EMAIL=noreply@yourdomain.com #MAIL_FROM_NAME=Python Mail Service #SERVER_MONITOR_ALERT_EMAIL=server-admin@igot.africa #SERVER_MONITOR_DISK_THRESHOLD=85.0 #SERVER_MONITOR_MEMORY_THRESHOLD=10.0 #SERVER_MONITOR_CPU_THRESHOLD=1.5 #LOG_LEVEL=INFO #LOG_FILE=python-app.log