Dify 0.6.12-fix1stable Released Jun 29, 2024
Impact Score: 5/10

Dify: v0.6.12-fix1

Source available — automated, not human-reviewed

Component: dify · Channel: stable. Automated analysis, not a compatibility certification. How this works.

Analysis updated: 2026-11-01.

Compatibility not verified — check source notes
📄 .MD
⚡ Executive Summary (TL;DR)

Dify 0.6.12-fix1. Source highlight: Fixed the issue where the WebApp URL was incorrect and the problem where the model and tools icons weren’t showing up after starting from Docker Compose with default `.env`.

Who Does This Impact? (Role-Based Analysis)

💻 Software Engineers & Devs

Check the source notes against the package and APIs you use before upgrading.

📊 Product & Engineering Leads

Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.

⚙️ DevOps & Security

Verify the target version, runtime requirements and rollback procedure in the official documentation.

✨ New Features & Capabilities (1)

  • add README for new docker/ directory

🔧 Bug Fixes & Patches (3)

  • fix: couldn't log in or resetup after a failed setup
  • fix: app config does not use empty string in the env
  • fix: env SMTP_PORT is empty caused err when launching
📄 View Raw Release Notes (Original Developer Log)
## 🛠️ v0.6.12-fix1 > [!WARNING] > Fixed the issue where the WebApp URL was incorrect and the problem where the model and tools icons weren’t showing up after starting from Docker Compose with default `.env`. --- ### 🎉 Upgrade to new docker compose deployment #### Key Changes 1. **Persistent Custom Environment Variables**: Users can now declare environment variables in .env that remain persistent across deployments. This change ensures that custom configurations are not lost during upgrades or redeployments. 2. **Unified Vector Database Services**: All vector database services have been consolidated into a single Docker file. Users can switch between different vector databases by modifying the `VECTOR_STORE` environment variable in your local `.env`. This simplifies the management of various vdb services and allows for more dynamic deployments. 3. **Mandatory .env File**: Unlike the previous deployment method, the new method requires an [.env] file before running `docker compose up`. Users should start by copying the `.env.example` file to create their own `.env` file. This step is crucial for configuring the deployment to meet specific needs. 4. **Legacy Support**: The previous deployment files have been moved to a `docker-legacy` directory. These files will no longer be maintained, but they are available for use if needed. #### Migrating For existing users who's customized `docker-compose.yaml`, `ssrf_proxy/squid.conf` or `nginx/conf.d/default.conf`, you may need to modify the corresponding environment variables in `.env` to reflect your existing changes. We are actively seeking feedback from the community to refine and enhance the deployment process. As more users adopt this new method, we will continue to make improvements based on your experiences and suggestions. #### How to Get Started To get started with the new deployment method: - Ensure you have Docker and Docker Compose installed on your system. - Navigate to the new `docker` directory. - Copy the `docker/.env.example` file to a new file named `.env` and customize it as needed. - Run `docker compose up` to start the services. We encourage all users to transition to this new method to take advantage of the improved flexibility and configuration options. Your feedback during this beta phase is invaluable and will help us make the deployment process even better. For detailed configuration options and environment variable settings, refer to the `.env.example` file and the Docker Compose configuration files in the [docker](https://github.com/langgenius/dify/tree/main/docker) directory. --- ## Upgrade Guide ### Docker compose deployments > [!WARNING] > The `docker-compose.yaml` has been refactored. If you've made any changes to the file, make sure to check out the "Upgrade to new docker compose deployment" section above for usage and migration tips. 1. Back up your customized docker-compose YAML file (optional) ```bash cd docker cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak ``` 2. Get the latest code from the main branch ```bash git checkout main git pull origin main ``` 3. Stop the service,Command, please execute in the docker directory ```bash docker compose down ``` 4. Back up data ```bash tar -cvf volumes-$(date +%s).tgz volumes ``` 5. Upgrade services ```bash docker compose up -d ``` ### Source Code deployments 1. Stop API server, Worker and Web frontend Server. 2. Get the latest code from the main branch: ```bash git checkout main git pull origin main ``` 3. Update Python dependencies: ```bash cd api poetry install ``` 7. Then, let's run the migration script: ```bash poetry shell flask db upgrade ``` 8. Finally, run API server, Worker and Web frontend Server again. ## What's Changed * add README for new docker/ directory by @guchenhe in https://github.com/langgenius/dify/pull/5724 * Chore/set entrypoint scripts permissions by @guchenhe in https://github.com/langgenius/dify/pull/5726 * Rename README to README.md by @guchenhe in https://github.com/langgenius/dify/pull/5727 * chore: support both $$ and $ latex format by @ZuzooVn in https://github.com/langgenius/dify/pull/5723 * fix: couldn't log in or resetup after a failed setup by @takatost in https://github.com/langgenius/dify/pull/5739 * fix: app config does not use empty string in the env by @takatost in https://github.com/langgenius/dify/pull/5741 * fix: env SMTP_PORT is empty caused err when launching by @takatost in https://github.com/langgenius/dify/pull/5742 **Full Changelog**: https://github.com/langgenius/dify/compare/0.6.12...0.6.12-fix1