# WAHA - WhatsApp HTTP API # # https://waha.devlike.pro/docs/how-to/config/ # # ================== # ===== COMMON ===== # ================== # Base URL for the API (used for webhooks, file URLs, etc.) WAHA_BASE_URL=http://localhost:3000 # Server configuration (if you need to customize hostname/port) # WHATSAPP_API_SCHEMA=http # WHATSAPP_API_PORT=3000 # WHATSAPP_API_HOSTNAME=localhost # ==================== # ===== SECURITY ===== # ==================== # "sha512:{SHA}" format - below is "admin" api key WAHA_API_KEY=sha512:c7ad44cbad762a5da0a452f9e854fdc1e0e7a52a38015f23f3eab1d80b931dd472634dfac71cd34ebc35d16ab7fb8a90c81f975113d6c7538dc69dd8de9077ec WAHA_DASHBOARD_ENABLED=True WAHA_DASHBOARD_USERNAME=admin WAHA_DASHBOARD_PASSWORD=admin WHATSAPP_SWAGGER_ENABLED=True WHATSAPP_SWAGGER_USERNAME=admin WHATSAPP_SWAGGER_PASSWORD=admin # WhatsApp engine (WEBJS is default, GOWS or NOWEB for better performance) WHATSAPP_DEFAULT_ENGINE=WEBJS # =================== # ===== LOGGING ===== # =================== # Log format: JSON (for log management systems) or PRETTY (for development) WAHA_LOG_FORMAT=JSON # Log level: info, debug, error, warn WAHA_LOG_LEVEL=info # Don't print QR codes in logs WAHA_PRINT_QR=False # ========================= # ===== MEDIA STORAGE ===== # ========================= # Local storage (default) WAHA_MEDIA_STORAGE=LOCAL WHATSAPP_FILES_LIFETIME=0 WHATSAPP_FILES_FOLDER=/app/.media # Media download settings # WHATSAPP_DOWNLOAD_MEDIA=true # WHATSAPP_FILES_MIMETYPES=image/jpeg,image/png # S3 storage (uncomment to use) # WAHA_MEDIA_STORAGE=S3 # WAHA_S3_REGION=eu-west-2 # WAHA_S3_BUCKET=waha # WAHA_S3_ACCESS_KEY_ID=minioadmin # WAHA_S3_SECRET_ACCESS_KEY=minioadmin # WAHA_S3_ENDPOINT=http://minio:9000 # WAHA_S3_FORCE_PATH_STYLE=True # WAHA_S3_PROXY_FILES=True # PostgreSQL storage (uncomment to use) # WAHA_MEDIA_STORAGE=POSTGRESQL # WAHA_MEDIA_POSTGRESQL_URL=postgres://postgres:postgres@postgres:5432/postgres?sslmode=disable # =========================== # ===== SESSION STORAGE ===== # =========================== # PostgreSQL for sessions (uncomment to use) # WHATSAPP_SESSIONS_POSTGRESQL_URL=postgres://postgres:postgres@postgres:5432/postgres?sslmode=disable # MongoDB for sessions (uncomment to use) # WHATSAPP_SESSIONS_MONGO_URL=mongodb://mongouser:mongopassword@mongodb:27017 # ================= # ===== APPS ====== # ================= # WAHA_APPS_ENABLED=True # REDIS_URL=redis://:redis@redis:6379 # Apps Jobs configuration - *_AGE in seconds # WAHA_APPS_JOBS_REMOVE_ON_COMPLETE_AGE= # WAHA_APPS_JOBS_REMOVE_ON_COMPLETE_COUNT= # WAHA_APPS_JOBS_REMOVE_ON_FAIL_AGE= # WAHA_APPS_JOBS_REMOVE_ON_FAIL_COUNT # ================================== # ===== ADVANCED CONFIGURATION ===== # ================================== # Timezone for screenshots and logs # TZ=Europe/Dublin # Session management # WHATSAPP_START_SESSION=session1,session2 # WHATSAPP_RESTART_ALL_SESSIONS=False # Webhooks # WHATSAPP_HOOK_URL=https://webhook.site/11111111-1111-1111-1111-11111111 # WHATSAPP_HOOK_CUSTOM_HEADERS=custom_header_key:custom_header_value # WHATSAPP_HOOK_EVENTS=session.status,message,message.reaction # Proxy configuration # WHATSAPP_PROXY_SERVER=proxy.example.com:3128 # WHATSAPP_PROXY_SERVER_USERNAME=user # WHATSAPP_PROXY_SERVER_PASSWORD=pass # HTTPS configuration # !DEPRECATED! # Setup nginx reverse proxy to handle TLS connection # using Let's encrypt or self-issued certificate # WAHA_HTTPS_ENABLED=true # WAHA_HTTPS_PATH_KEY=/etc/letsencrypt/live/waha.example.pro/privkey.pem # WAHA_HTTPS_PATH_CERT=/etc/letsencrypt/live/waha.example.pro/cert.pem # WAHA_HTTPS_PATH_CA=/etc/letsencrypt/live/waha.example.pro/chain.pem