how to upgrade from 1.4.1 to 1.13.0

[HojaMuerta]

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.

Content

I upgraded from version 1.4.1 to 1.13.0. Are there any points I should be aware of? For example, has the PostgreSQL container name changed, will there be any issues with database migration, and are there any permission-related concerns?

[dosubot[bot]]

Here are the key points for upgrading from 1.4.1 to 1.13.0:

🔴 Critical: PostgreSQL Container Name Change

The hostname changed from db to db_postgres. Update your .env file:

DB_HOST=db_postgres

Failure to do this will cause "could not translate host name 'db' to address" errors.

Environment Variable Updates

Database credentials were consolidated to a unified format:

DB_USERNAME=postgres
DB_PASSWORD=difyai123456
DB_DATABASE=dify
DB_TYPE=postgresql
COMPOSE_PROFILES=${VECTOR_STORE:-weaviate},${DB_TYPE:-postgresql}

File Permissions (v1.10.1+)

Containers now run as non-root user (UID 1001). Fix ownership:

sudo chown -R 1001:1001 ./volumes/app/storage

Upgrade Steps

1. Backup everything:

   cp -r dify "dify.bak.$(date +%Y%m%d%H%M%S)"

2. Stop containers:

   docker compose down

3. Pull updates and update .env:

   git pull

4. Start with profile:

   docker compose pull
   docker compose --profile postgresql up -d

5. Run migrations if needed:

   docker compose exec api uv run flask db upgrade

If using Weaviate, you'll also need to upgrade to v1.27.0+ and expose gRPC port 50051.

Since you're jumping several versions, I'd recommend testing in a staging environment first if possible!

To reply, just mention @dosu.

---

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