Help, Which is the most stable, safe, and simple procedure to upgrade from Dify v1.0.1 to the latest version v1.10.1

[dreambe]

Self Checks

• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
• [FOR CHINESE USERS] 请务必使用英文提交 Issue，否则会被关闭。谢谢！:)
• Please do not modify this template :) and fill in all the required fields.

1. Is this request related to a challenge you're experiencing? Tell me about your story.

my dify version is 1.0.1 ,but it has many unsupport feature and bugs. SO I want to upgrade to the latest version, That's all

2. Additional context or comments

No response

[dosubot[bot]]

Hi @dreambe! I'm Dosu and I’m helping the dify team.

Here’s the most stable, safe, and simple procedure to upgrade Dify from v1.0.1 to v1.10.1 (Docker Compose):

1. Backup everything: Before you start, back up your database, the entire dify/docker/volumes directory, your .env file, and optionally your docker-compose.yaml. This ensures you can recover if anything goes wrong.
   Example:

   cd dify/docker
   tar -cvf volumes-backup-$(date +%s).tgz volumes
   cp .env .env.bak
   cp docker-compose.yaml docker-compose.yaml.bak

   Reference

2. Stop all running containers:

   docker compose down

   This avoids issues with container naming changes and prevents multiple containers from mounting the same volume, which can corrupt your database.
   Reference

3. Pull the latest code and images:

   git pull origin main
   docker compose pull

   Reference

4. Sync your .env file:
   Check if .env.example has new variables or changed values. Update your .env file to match any new requirements.
   Reference

5. Restart services:

   docker compose up -d

6. Run database migrations:
   Enter your API container and run:

   docker exec -it dify-api-1 bash
   uv run flask db upgrade

   If you’re still on a version using poetry, use:

   poetry run flask db upgrade

   Reference

7. Migrate plugins and vector DB (if needed):
   If you used model providers before plugins, run:

   uv run flask extract-plugins --workers=20
   uv run flask install-plugins --workers=2

   For vector DB migration:

   uv run flask vdb-migrate --scope=all

   Reference

8. Verify your upgrade:
   Log in to Dify, check the Plugins section, and confirm your tools and models are working. Test your workflows and data.

Tips:

• Always stop old containers before pulling new code to avoid running multiple containers with the same volume.
• Review release notes for each version if you want to catch minor breaking changes or new config options.
• If you hit issues with plugins or models, you may need to manually re-enter plugin keys or check provider settings.

This procedure is the safest and simplest path for Docker Compose deployments. If you’re using source code or a custom setup, let me know for tailored steps.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[dreambe]

thanks a lot!