v7.9.0
aldinokemal/go-whatsapp-web-multidevicev7.9.0Nov 18, 2025by aldinokemal
AI Summary
A feature release adding comprehensive reverse proxy support and configurable media download controls, alongside critical bug fixes for database operations.
Key Highlights
- New APP_TRUSTED_PROXIES configuration for reverse proxy deployments
- New WHATSAPP_AUTO_DOWNLOAD_MEDIA configuration option
- Enhanced message editing webhook with original_message_id
- Fixed 'file is being used by another process' error during logout
New Features
- Reverse proxy header support
- Auto-download media control
- Enhanced webhook payload for message editing
- Database cleanup fix during logout
Full Release Notes
## What's New in v7.9.0
⨠**New Features & Enhancements**
- **Reverse Proxy Support**: Added comprehensive support for reverse proxy deployments
- **Trusted Proxy Configuration**: New `APP_TRUSTED_PROXIES` environment variable and `--trusted-proxies` CLI flag
- **Correct URL Generation**: Properly reads `X-Forwarded-Host` and `X-Forwarded-Proto` headers from trusted proxies
- **Fixes QR Code URLs**: Resolves issue where QR code URLs showed internal container hostnames instead of public domains
- **Flexible Configuration**: Supports specific IP ranges/CIDRs or trust all proxies with `0.0.0.0/0`
- **Auto-Download Media Control**: New configuration option to control automatic media downloads
- **Configurable Behavior**: `--auto-download-media` flag and `WHATSAPP_AUTO_DOWNLOAD_MEDIA` environment variable
- **Defaults to Enabled**: Auto-download is enabled by default, maintaining backward compatibility
- **Media Type Coverage**: Affects audio, documents, images, stickers, and video messages
- **Enhanced Webhook Payload**: Message editing webhook now includes `original_message_id`
- **Better Tracking**: Easier to track which message was modified in your database
- **Database Update Support**: Simplifies updating records when messages are edited
š **Bug Fixes & Improvements**
- **Database Cleanup Fix**: Fixed "file is being used by another process" error during logout
- **Proper Connection Closure**: Database connections are now properly closed before file deletion
- **Both Databases Handled**: Closes both main database and keys database connections
- **Cross-Platform Support**: Resolves file locking issues on Windows and other platforms
- **WhatsApp Client Assignment**: Fixed WhatsApp client initialization
- **Correct Assignment**: Properly assigns the client returned by `InitWaCLI` to `whatsappCli`
- **Prevents Nil References**: Ensures the client is correctly initialized for all operations
- **Timezone Configuration**: Added proper timezone handling and configuration
## šÆ **What This Means for You**
### For Reverse Proxy Users (Caddy, nginx, Kong, Traefik, etc.)
- **Correct Public URLs**: API responses now return your public domain URLs instead of internal container names
- **Easy Configuration**: Simply set `APP_TRUSTED_PROXIES=0.0.0.0/0` in your environment or use the CLI flag
- **Secure Deployment**: Specify exact IP ranges for enhanced security in production
### For All Users
- **Reliable Logout**: No more "file in use" errors when logging out
- **Better Media Control**: Choose whether to automatically download media or download on-demand
- **Enhanced Webhooks**: Track message edits more easily with the original message ID
- **Improved Stability**: Multiple bug fixes for more reliable operation
## Important Notes
ā
**Reverse Proxy Configuration**
- Set `APP_TRUSTED_PROXIES` to enable proxy header support
- For development: `APP_TRUSTED_PROXIES=0.0.0.0/0` (trust all)
- For production: Specify your proxy IP ranges like `APP_TRUSTED_PROXIES=10.0.0.0/8,172.16.0.0/12`
- Can also use CLI flag: `./whatsapp rest --trusted-proxies="0.0.0.0/0"`
ā
**Media Download Configuration**
- Default behavior unchanged: media is auto-downloaded
- To disable: Set `WHATSAPP_AUTO_DOWNLOAD_MEDIA=false` or use `--auto-download-media=false`
- Affects: audio, documents, images, stickers, videos from incoming messages
ā
**Breaking Changes**
- None - all changes are backward compatible
- Existing deployments will continue to work without configuration changes
š§ **Recommended Actions**
- If deploying behind a reverse proxy, configure `APP_TRUSTED_PROXIES` for correct URL generation
- Update your `.env` file based on the updated `.env.example`
- If experiencing high storage usage, consider disabling auto-download media
## Configuration Examples
**Using Environment Variables:**
```bash
APP_TRUSTED_PROXIES=0.0.0.0/0
WHATSAPP_AUTO_DOWNLOAD_MEDIA=true
```
**Using CLI Flags:**
```bash
./whatsapp rest --trusted-proxies="0.0.0.0/0" --auto-download-media=false
```
**Docker Compose:**
```yaml
environment:
- APP_TRUSTED_PROXIES=0.0.0.0/0
- WHATSAPP_AUTO_DOWNLOAD_MEDIA=true
```
## Summary
Version 7.9.0 is a feature-rich release that adds critical reverse proxy support, giving users full control over media downloads, and fixing important bugs related to database cleanup and client initialization. The new trusted proxy configuration resolves URL generation issues for users deploying behind reverse proxies like Caddy, nginx, or Kong. The auto-download media feature provides flexibility for managing storage and bandwidth usage. Combined with bug fixes for logout operations and client initialization, this release improves both functionality and reliability for all deployment scenarios.
## What's Changed
* Fix: assign the client returned by InitWaCLI to whatsappCli. (#467) by @moz4rtdev in https://github.com/aldinokemal/go-whatsapp-web-multidevice/pull/468
* Fix logout bug by closing database connections before file deletion (#464) by @aldinokemal in https://github.com/aldinokemal/go-whatsapp-web-multidevice/pull/469
* feat: add auto-download media feature and configuration options
* feat: add trusted proxy configuration support for reverse proxy deployments
* feat: enhance message editing webhook payload with original_message_id
* feat: add timezone configuration and handling
## New Contributors
* @moz4rtdev made their first contribution in https://github.com/aldinokemal/go-whatsapp-web-multidevice/pull/468
**Full Changelog**: https://github.com/aldinokemal/go-whatsapp-web-multidevice/compare/v7.8.2...v7.9.0