Help: upgrade from 1.11.4 to 1.14-rc1 failed

[simonjhy]

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.

I download 1.14-rc1 version to local and copy the vlolumes used by 1.11.4 to docker folder. When start docker compose up -d, I checkec docker-api-1 log, I found the logs show below errors. How to resolve this?

Warning! You didn't set docs_url, redoc_url or openapi_url.
API Documentation will be skipped.
Preparing database migration...
Database migration skipped
[2026-03-11 05:47:11 +0000] [1] [INFO] Starting gunicorn 23.0.0
[2026-03-11 05:47:11 +0000] [1] [INFO] Listening at: http://0.0.0.0:5001 (1)
[2026-03-11 05:47:11 +0000] [1] [INFO] Using worker: gevent
[2026-03-11 05:47:11 +0000] [156] [INFO] Booting worker with pid: 156
gRPC patched with gevent.
psycopg2 patched with gevent.
2026-03-11 05:47:16.957 INFO [MainThread] [utils.py:151] - Note: NumExpr detected 64 cores but "NUMEXPR_MAX_THREADS" not set, so enforcing safe limit of 16.
2026-03-11 05:47:16.958 INFO [MainThread] [utils.py:164] - NumExpr defaulting to 16 threads.
2026-03-11 05:47:19.206 INFO [MainThread] [plugins.py:37] - setup plugin alembic.autogenerate.schemas
2026-03-11 05:47:19.208 INFO [MainThread] [plugins.py:37] - setup plugin alembic.autogenerate.tables
2026-03-11 05:47:19.208 INFO [MainThread] [plugins.py:37] - setup plugin alembic.autogenerate.types
2026-03-11 05:47:19.208 INFO [MainThread] [plugins.py:37] - setup plugin alembic.autogenerate.constraints
2026-03-11 05:47:19.209 INFO [MainThread] [plugins.py:37] - setup plugin alembic.autogenerate.defaults
2026-03-11 05:47:19.209 INFO [MainThread] [plugins.py:37] - setup plugin alembic.autogenerate.comments
Warning! You didn't set docs_url, redoc_url or openapi_url.
API Documentation will be skipped.
2026-03-11 05:47:21.555 WARNING [Dummy-1] [api_token_service.py:329] ef2d5c4f143e5f8d8f3f5401fbce95c2 - Redis lock failed for token query: (psycopg2.OperationalError) could not translate host name "db_postgres" to address: Temporary failure in name resolution

(Background on this error at: https://sqlalche.me/e/20/e3q8), proceeding anyway
2026-03-11 05:47:21.559 ERROR [Dummy-1] [app.py:875] ef2d5c4f143e5f8d8f3f5401fbce95c2 - Exception on /v1/parameters [GET]
Traceback (most recent call last):
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/engine/base.py", line 143, in init
self._dbapi_connection = engine.raw_connection()
^^^^^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/engine/base.py", line 3309, in raw_connection
return self.pool.connect()
^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/base.py", line 447, in connect
return _ConnectionFairy._checkout(self)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/base.py", line 1264, in _checkout
fairy = _ConnectionRecord.checkout(pool)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/base.py", line 711, in checkout
rec = pool._do_get()
^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/impl.py", line 177, in _do_get
with util.safe_reraise():
^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/util/langhelpers.py", line 224, in exit
raise exc_value.with_traceback(exc_tb)
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/impl.py", line 175, in _do_get
return self._create_connection()
^^^^^^^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/base.py", line 388, in _create_connection
return _ConnectionRecord(self)
^^^^^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/base.py", line 673, in init
self.__connect()
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/base.py", line 899, in __connect
with util.safe_reraise():
^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/util/langhelpers.py", line 224, in exit
raise exc_value.with_traceback(exc_tb)
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/pool/base.py", line 895, in __connect
self.dbapi_connection = connection = pool._invoke_creator(self)
^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/engine/create.py", line 661, in connect
return dialect.connect(*cargs, **cparams)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/engine/default.py", line 630, in connect
return self.loaded_dbapi.connect(*cargs, **cparams) # type: ignore[no-any-return] # NOQA: E501
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/app/api/.venv/lib/python3.12/site-packages/psycopg2/init.py", line 122, in connect
conn = _connect(dsn, connection_factory=connection_factory, **kwasync)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
psycopg2.OperationalError: could not translate host name "db_postgres" to address: Temporary failure in name resolution

2. Additional context or comments

No response

[dosubot[bot]]

The error occurs because the PostgreSQL service name changed from db to db_postgres in Dify 1.14, and Docker Compose profiles must now be explicitly enabled for the database service to start. This was introduced in PR #29092.

To fix this:

1. Update your .env file to use the new database environment variables and enable the PostgreSQL profile:

   DB_HOST=db_postgres
   DB_TYPE=postgresql
   COMPOSE_PROFILES=${VECTOR_STORE:-weaviate},${DB_TYPE:-postgresql}

2. Start with the profile enabled:

   docker compose --profile postgresql up -d

After the containers start:

• Run database migrations: docker compose exec api uv run flask db upgrade
• Fix file permissions (containers now run as non-root UID 1001): sudo chown -R 1001:1001 ./volumes/app/storage

This is a known issue affecting many users upgrading from 1.11.x to 1.13-1.14. See this discussion for more details on configuration changes between versions.

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.