Skip to content

feat: update openwa template to 0.25.0 - #1260

Open
duducp wants to merge 3 commits into
Dokploy:canaryfrom
duducp:feat/openwa-0.25.0
Open

duducp wants to merge 3 commits into
Dokploy:canaryfrom
duducp:feat/openwa-0.25.0

Conversation

@duducp

@duducp duducp commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Summary

This PR updates the OpenWA blueprint from 0.24.0 to 0.25.0, enables the MCP server by default, and keeps Swagger UI available.

Changes

  • Update ghcr.io/rmyndharis/openwa to 0.25.0
  • Add stop_grace_period: 75s to match the upstream production teardown budget introduced in 0.25.0
  • Enable MCP with MCP_ENABLED=true and expose the mcp_enabled variable
  • Keep the upstream-recommended read-only tier by default (MCP_READONLY=true), exposed as mcp_readonly
  • Enable Swagger UI with ENABLE_SWAGGER=true, exposed as enable_swagger

The hardened runtime settings are otherwise unchanged: the required KILL capability is already present, and the new optional variables in 0.25.0 (MESSAGE_INLINE_MEDIA, WEBHOOK_FAILURE_PAYLOAD_RETENTION_HOURS, STORAGE_IMPORT_MAX_TOTAL_BYTES) keep their upstream defaults.

MCP

After deployment the server is reachable at https://<domain>/mcp. MCP clients authenticate with an OpenWA API key.

  • mcp_readonly = "true" (default): 25 read tools
  • mcp_readonly = "false": all 51 tools, including sends and mutations

The docs recommend keeping /mcp off the public internet unless it is fronted by an authentication proxy, and using a dedicated, session-scoped operator key.

Swagger

Swagger UI is reachable at https://<domain>/api/docs. The template runs with NODE_ENV=production, where upstream disables Swagger by default, so the template explicitly sets ENABLE_SWAGGER=true.

The Swagger mount is not behind the API-key guard, so it exposes the API schema and the running version to anyone who can reach the instance. Set enable_swagger = "false" to turn it off.

Highlights in 0.25.0

  • Bounded webhook failure redrive with optional payload retention
  • Chat-restricted API keys and MCP keys now respect their chat allowlist
  • Polls exposed in message events and history
  • Archive-only chat media with dashboard previews
  • Safer shutdown handling with bounded queue, webhook and engine teardown
  • Docker healthcheck now probes the configured PORT

Validation

  • bun build-scripts/generate-meta.js --check: 586 templates validated
  • docker compose config -q: passes
  • TOML parses successfully
  • Verified ghcr.io/rmyndharis/openwa:0.25.0 exists

- Update OpenWA image to 0.25.0
- Add 75s stop grace period for the longer bounded teardown
@github-actions

github-actions Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
templates ✅ Ready (View Log) Visit Preview 6b4d613

- Add mcp_enabled and mcp_readonly template variables
- Pass MCP_ENABLED and MCP_READONLY to the container
- Keep the read-only tool tier as the safe default
Add an enable_swagger variable, wired to ENABLE_SWAGGER, so /api/docs is
served despite the upstream production default.

This branch was successfully deployed

1 active deployment
Preview — 6b4d6134 Deployed Oct 28, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant