# WAHA - WhatsApp HTTP API # # https://waha.devlike.pro/docs/how-to/config/ # # ==================== # ===== SECURITY ===== # ==================== WAHA_API_KEY=00000000000000000000000000000000 WAHA_DASHBOARD_USERNAME=admin WAHA_DASHBOARD_PASSWORD=11111111111111111111111111111111 WHATSAPP_SWAGGER_USERNAME=admin WHATSAPP_SWAGGER_PASSWORD=11111111111111111111111111111111 # Disable Dashboard or Swagger WAHA_DASHBOARD_ENABLED=True WHATSAPP_SWAGGER_ENABLED=True # ================== # ===== COMMON ===== # ================== # WhatsApp engine (WEBJS is default, GOWS or NOWEB for better performance) WHATSAPP_DEFAULT_ENGINE=WEBJS # So you don't have to create sessions/apps when switching between engines WAHA_NAMESPACE=all # "Firefox (YourApp)" in Linked Devices # WAHA_CLIENT_DEVICE_NAME=YourApp # Base URL for the API (used for webhooks, file URLs, etc.) WAHA_BASE_URL=http://localhost:3000 # WAHA_PUBLIC_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 # =================== # ====== GOWS ======= # =================== # By default, GOWS uses cgo (libc) DNS resolver # You can ask to use golang one, but it's less reliable # GODEBUG=netdns=go # =================== # ===== 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 # # Events (webhooks, websockets) # WAHA_EVENTS_DOWNLOAD_MEDIA=true # WAHA_EVENTS_DOWNLOAD_MEDIA_MIMETYPES=image/jpeg,image/png # API default behavior (GET /api/{session}/chats/{chatId}/messages, etc.) # WAHA_API_DOWNLOAD_MEDIA=true # WAHA_API_DOWNLOAD_MEDIA_MIMETYPES=image/jpeg,image/png # DEPRECATED - use WAHA_EVENTS_* and WAHA_API_* variables above # 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