Traceary

Catalog / Dify

1.9.2

v1.9.2 - Sharper, Faster, and More Reliable

10 months agoaddedfixedchangedOriginal notes

This release focuses on improving stability, async performance, and developer experience. Expect cleaner internals, better workflow control, and improved observability across the stack.


[!WARNING]

A recent change has modernized the Dify integration for Weaviate (see PR #25447 and related update in PR #26964). The upgrade switches the Weaviate Python client from v3 to v4 and raises the minimum required Weaviate server version to 1.24.0 or newer. With this update:

  • If you are running an older Weaviate server (e.g., v1.19.0), you must upgrade your server to at least v1.24.0 before updating Dify.
  • The code now uses the new client API and supports gRPC for faster operations, which may require opening port 50051 in your Docker Compose files.
  • Data migration between server versions may require re-indexing using Weaviate’s Cursor API or standard backup/restore procedures.
  • The Dify documentation will be updated to provide migration steps and compatibility guidance.

Action required:

  • Upgrade your Weaviate server to v1.24.0 or higher.
  • Follow the migration guide to update your data and Docker configuration as described in the latest official Dify documentation.
  • Ensure your environment meets the new version requirements before deploying Dify updates.

✨ Highlights

Workflow & Agents

Integrations & SDK

Web & UI

  • Faster load times by splitting and lazy‑loading constant files (by @yangzheli in #26794)
  • Improved DataSources with marketplace plugin integration and filtering (by @WTW0313 in #26810)
  • Added tax tooltips to pricing footer (by @CodingOnStar in #26705)
  • Account creation now syncs interface language with display settings (by @feelshana in #27042)

⚙️ Core Improvements


🧩 Fixes


🧹 Cleanup & DevX


Upgrade Guide

Docker Compose Deployments

  1. Back up your customized docker-compose YAML file (optional)

    cd docker
    cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak
    
  2. Get the latest code from the main branch

    git checkout main
    git pull origin main
    
  3. Stop the service. Please execute in the docker directory

    docker compose down
    
  4. Back up data

    tar -cvf volumes-$(date +%s).tgz volumes
    
  5. Upgrade services

    docker compose up -d
    

Source Code Deployments

  1. Stop the API server, Worker, and Web frontend Server.

  2. Get the latest code from the release branch:

    git checkout 1.9.2
    
  3. Update Python dependencies:

    cd api
    uv sync
    
  4. Then, let's run the migration script:

    uv run flask db upgrade
    
  5. Finally, run the API server, Worker, and Web frontend Server again.


What's Changed

These notes run past the length kept in the archive. The rest is on the publisher’s page.