Key details

  1. Coolify v4.6.0 published November 2, 2026 UTC as a stable, non-prerelease tag.
  2. Member and token grants can be scoped to individual projects, environments and resources.
  3. New delete ability or root is required for destructive REST API and MCP calls; write alone no longer suffices.
  4. Token permissions never exceed the owner's scope and expire with revoked membership.
  5. New MCP tools manage DNS, integration tokens, Cloudflare tunnels and secret-manager associations.
  6. Release includes GitHub Actions lockfile/pinning, secret-response redaction and tighter Reverb routing.
  7. Update channels now include stable, preview and nightly; Windows Docker Desktop support was removed.
  8. Published documentation may not yet reflect the v4.6.0 delete-permission change.

What builders should take away

  1. Inventory API/MCP tokens and compare their permissions against actual deployment, configuration and deletion operations before upgrading.
  2. Create separate least-privilege tokens per environment and resource; avoid root tokens for ordinary agent workflows.
  3. Re-test delete endpoints and MCP tools after upgrading, especially CI cleanup jobs and automated backups.
  4. Check DNS and secret-manager MCP tools against your approval policy and audit logs before allowing autonomous changes.
  5. Review Docker Engine, image-tag and release-channel compatibility for self-hosted installations.

What changed

Coolify released stable v4.6.0 on November 2, 2026 (UTC). It adds resource-scoped permissions for team members and API tokens, with read, read sensitive, deploy, write, delete and root levels. Grants can be restricted to selected projects, environments or individual resources; token permissions cannot exceed the owner's. Breaking change: delete operations through REST API and MCP now require the new delete ability or root, not write alone. The release also adds MCP/API management of Cloudflare DNS records, integration tokens and secret managers, changes instance update channels and hardens GitHub Actions, secret responses and Reverb routing.

Why it matters

Coolify is a privileged control plane for servers and deployed workloads. Previously, broad write access exposed a large destructive surface to CI jobs and AI agents. Scoped grants can reduce the blast radius of a leaked or misused token, while the new delete requirement may intentionally break existing automations. Operators must audit tokens and workflows rather than assuming that a successful upgrade preserves every API permission.

Access can now follow the resource rather than the whole team

Administrators can grant viewer, developer, operator or full presets, or configure granular access to projects, environments and resources. Limited users and tokens should see only their permitted inventories, deployments and search results. Revoking a user's access also invalidates dependent tokens. The hierarchy adds explicit delete and root privileges beyond read, read sensitive, deploy and write.

Existing deletion workflows need a permission audit

A write-only token can no longer delete resources, environment variables, storage, backups, scheduled tasks or tags through the API or MCP. Operators should identify integrations that intentionally delete and grant delete only where necessary. Do not solve the upgrade by distributing root tokens indiscriminately. Documentation pages may lag the release: several current API references still describe write-based deletion, so use the tagged v4.6.0 release notes as the version-specific authority.

AI agents get more infrastructure actions, with higher stakes

New MCP tools can manage DNS, integration tokens, Cloudflare tunnels and secret-manager associations. Secret-manager APIs list key names but do not return secret values, according to the release notes. These capabilities make agent workflows more useful but expand the set of actions that warrant explicit approvals, scoped tokens and audit review.

Release and supply-chain operations change

Stable, preview and nightly channels are selectable. CI workflows pin actions to full commit SHAs and a lockfile including repository identity; release credentials are separated by environment. The build process now uses zstd-compressed image layers and requires a compatible Docker Engine. The release removes Windows Docker Desktop support and some moving image tags, so operators relying on old deployment assumptions should review the full changelog.

What to watch next

  • Corrections to API/MCP documentation and generated endpoint schemas for the new delete ability.
  • Post-upgrade permission regressions and reports of over-broad access or hidden resources.
  • Security advisories related to the new DNS and secret-management endpoints.
  • Production stability of preview/nightly release channels and update migrations.

Still unclear

  • The detailed security fixes are release-author claims; no independent penetration test of the new access-control model was found.
  • The scope and behaviour of every third-party integration after upgrade cannot be established from release notes alone.
  • Current documentation pages describe older token permissions in places; version-specific 4.6 behaviour needs live testing.

Sources

Direct reading behind this dossier.

4 sources
Coolify v4.6.0 release notes
Coolify primary

Authoritative tagged release; scoped access, delete breaking change, MCP additions, security hardening and migration notes.

Coolify MCP security
Coolify primary documentation

Agent access risks, least-privilege recommendations and token handling; current docs may lag release.

Coolify 4.5.3 release notes
Coolify primary

Previous release baseline distinguishes 4.6's new scoped-access and deletion model from 4.5 fixes.

Discussion

Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.

0 visible comments

Join the discussion

Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.

Sign in to comment