v3.18.0
LTS
Released Dec 1, 2025·Supported until Dec 1, 2026·Community 1.18.0·Enterprise 0.21.0
Breaking
2 to verify
Security
Clean
Changes
6F · 3B
Downtime
~45s migration
Upgrade Impact
Breaking:two breaking changes. Database migration required (~45s on typical dataset).
Conversation history schema normalisedThe `messages` table is split into `messages` + `message_metadata`. Migration is automatic but locks the table for ~45s.
Removed legacy /v1/chat endpointClients must migrate to /v2/chat. The v1 endpoint has been deprecated since v3.14.
What Changed
9New Feature
Agent memory with retrieval-augmented generationAgents can now persist long-term memory across sessions, backed by vector search over past conversations.
Visual workflow debuggerStep through workflow execution node-by-node with live variable inspection and breakpoints.
Native Slack and Teams integrationDeploy chatbots to Slack and Microsoft Teams with zero-code configuration from the console.
Custom model provider SDKRegister self-hosted or third-party LLM providers via a standardised TypeScript SDK.
Granular RBAC for knowledge basesPer-dataset read/write/admin permissions with inheritance from workspace roles.
Batch workflow execution APISubmit up to 1000 workflow runs in a single API call with aggregated result callbacks.
Bug Fixes
Fixed SSO group sync failing silently on large directoriesLDAP group sync now paginates correctly for directories with >10k groups.
Resolved OOM during large PDF ingestionPDF parsing now streams pages instead of loading the entire document into memory.
Corrected timezone handling in scheduled triggersCron triggers now respect the workspace timezone setting instead of defaulting to UTC.
Upgrade Guide
Pre-Upgrade Checklist
Schedule a maintenance window (~2 min) for the database migration
Back up PostgreSQL database and Redis data
Migrate API clients from /v1/chat to /v2/chat before upgrading
Verify current version is v3.16.x or v3.17.x (direct upgrade path supported)
Confirm Kubernetes cluster has sufficient resources for rolling update
Upgrade Command
# Requires brief downtime for DB migration:
$ helm upgrade -i dify -f values.yaml dify-ee/dify --version 3.18.0
Rollback
$ helm rollback dify 0
Security & CVE
No security vulnerabilities fixed in this release.0 Critical · 0 High CVE across all container images
Image
dify-enterprise-api
dify-enterprise-gateway
dify-enterprise-frontend
dify-enterprise-backend
dify-enterprise-worker
critical
0
0
0
0
0
high
0
0
0
0
0
medium
1
0
0
1
0
low
2
1
3
0
1
Status
PASS
PASS
PASS
PASS
PASS
ScannerTrivy v0.61.0
Scanned
Dec 1, 2025
Data Source
Docker
Benchmark Report
TTFE – Time To First Event (ms)
AVG
58.12
MIN
38
MAX
265
P50
51
P90
63.8
P95
98
Connections
Max Concurrent
85
Avg Active
48.6
Empty Workflow QPS
Max QPS
92.3
Avg QPS
51.87
Avg Duration (ms)
63.14
License Compliance
All dependencies compliant- no copyleft issues detected
MITApache-2.0BSD