[Bug]: Docker cannot be upgraded from V0.3.15 to V0.3.19 or later

[xktder]

Bug Description

Docker cannot be upgraded from V0.3.15 to V0.3.19 or later

I originally had version V0.3.15, but when upgrading to V0.3.19, 20, and 21, all started with errors. The key issue is that I hadn't changed any configuration at all. How should it be handled? Isn't it that you have to delete and start over? That would be awkward.

Below is the configuration of my component

services:
  openviking:
    image: openviking/openviking
    container_name: openviking
    ports:
      - "11933:1933"
      - "18020:8020"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /volume2/docker/openviking/ov.conf:/app/.openviking/ov.conf
      - /volume2/docker/openviking/data:/app/data
    restart: unless-stopped
    network_mode: "bridge"
    # 直接覆盖 command，启用写入模式    
    command: ["sh", "-c", "openviking-server & SERVER_PID=$$!; sleep 5; python -m openviking.console.bootstrap --host 0.0.0.0 --port 8020 --openviking-url http://127.0.0.1:1933 --write-enabled & wait $$SERVER_PID "]
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:1933/health || exit 1"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 30s
    logging:
        options:
            max-size: "10m"
            max-file: "3"

ov.config的config.

{
  "server": {
    "host": "0.0.0.0",
    "port": 1933,
    "root_api_key": "123",
    "cors_origins": ["*"]
  },
  "storage": {
    "workspace": "./data",
    "vectordb": {
      "name": "context",
      "backend": "local"
    },
    "agfs": {
      "port": 1833,
      "log_level": "warn",
      "backend": "local"
    }
  },
  "embedding": {
    "dense": {
      "api_base" : "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "api_key"  : "sk-23XXXXXXXae63",
      "provider" : "openai",
      "dimension": 1024,
      "model"    : "tongyi-embedding-vision-plus-2026-03-06"
    },
    "max_concurrent": 10
  },
  "vlm": {
    "api_base" : "https://9router.XXXXXXXX:36500/v1",
    "api_key"  : "sk-1af878XXXXXXXXX05ba56",
    "provider" : "openai",
    "model"    : "agent-common",
    "max_concurrent": 10
  },
"memory": {
    "version": "v2"
  },
 "output_language_override": "zh-CN"
}

Steps to Reproduce

I don't know if you can reproduce it. I've been using version V0.3.15 repeatedly, working fine, then upgrading to V0.3.19 won't start. Neither 20 nor 21 is allowed.

Expected Behavior

Upgrade to the latest version normally and start normally.

Actual Behavior

Cannot be upgraded.

Minimal Reproducible Example

Error Logs

/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
2026-05-28 08:02:42,716 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:02:42,716 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
/app/.venv/bin/python: Error while finding module specification for 'openviking.console.bootstrap' (ModuleNotFoundError: No module named 'openviking.console')
2026-05-28 08:02:55,787 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:02:55,787 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:02:56.964 | INFO     | openviking.telemetry.tracer:init_tracer_from_server_config:149 - [TRACER] disabled in server.observability.traces
[05/28/26 08:02:56] INFO     StreamableHTTP       streamable_http_manager.py:128
                             session manager                                    
                             started                                            
OpenViking HTTP Server is running on 0.0.0.0:1933
2026-05-28 08:02:58,343 - openviking.server.app - ERROR - Deferred initialization failed, exiting
Traceback (most recent call last):
  File "/app/.venv/lib/python3.13/site-packages/openviking/server/app.py", line 177, in _deferred_init
    await service.initialize()
  File "/app/.venv/lib/python3.13/site-packages/openviking/service/core.py", line 272, in initialize
    await init_context_collection(self._vikingdb_manager)
  File "/app/.venv/lib/python3.13/site-packages/openviking/storage/collection_schemas.py", line 290, in init_context_collection
    raise EmbeddingRebuildRequiredError(
    ...<2 lines>...
    )
openviking.storage.errors.EmbeddingRebuildRequiredError: Existing collection embedding metadata does not match current configuration. Rebuild is required before using the current embedding model.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
2026-05-28 08:03:00,224 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:00,224 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
/app/.venv/bin/python: Error while finding module specification for 'openviking.console.bootstrap' (ModuleNotFoundError: No module named 'openviking.console')
2026-05-28 08:03:07,260 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:07,260 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:07.821 | INFO     | openviking.telemetry.tracer:init_tracer_from_server_config:149 - [TRACER] disabled in server.observability.traces
[05/28/26 08:03:07] INFO     StreamableHTTP       streamable_http_manager.py:128
                             session manager                                    
                             started                                            
OpenViking HTTP Server is running on 0.0.0.0:1933
2026-05-28 08:03:09,039 - openviking.server.app - ERROR - Deferred initialization failed, exiting
Traceback (most recent call last):
  File "/app/.venv/lib/python3.13/site-packages/openviking/server/app.py", line 177, in _deferred_init
    await service.initialize()
  File "/app/.venv/lib/python3.13/site-packages/openviking/service/core.py", line 272, in initialize
    await init_context_collection(self._vikingdb_manager)
  File "/app/.venv/lib/python3.13/site-packages/openviking/storage/collection_schemas.py", line 290, in init_context_collection
    raise EmbeddingRebuildRequiredError(
    ...<2 lines>...
    )
openviking.storage.errors.EmbeddingRebuildRequiredError: Existing collection embedding metadata does not match current configuration. Rebuild is required before using the current embedding model.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
2026-05-28 08:03:10,796 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:10,796 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
/app/.venv/bin/python: Error while finding module specification for 'openviking.console.bootstrap' (ModuleNotFoundError: No module named 'openviking.console')
2026-05-28 08:03:17,810 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:17,810 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:18.375 | INFO     | openviking.telemetry.tracer:init_tracer_from_server_config:149 - [TRACER] disabled in server.observability.traces
[05/28/26 08:03:18] INFO     StreamableHTTP       streamable_http_manager.py:128
                             session manager                                    
                             started                                            
OpenViking HTTP Server is running on 0.0.0.0:1933
2026-05-28 08:03:19,653 - openviking.server.app - ERROR - Deferred initialization failed, exiting
Traceback (most recent call last):
  File "/app/.venv/lib/python3.13/site-packages/openviking/server/app.py", line 177, in _deferred_init
    await service.initialize()
  File "/app/.venv/lib/python3.13/site-packages/openviking/service/core.py", line 272, in initialize
    await init_context_collection(self._vikingdb_manager)
  File "/app/.venv/lib/python3.13/site-packages/openviking/storage/collection_schemas.py", line 290, in init_context_collection
    raise EmbeddingRebuildRequiredError(
    ...<2 lines>...
    )
openviking.storage.errors.EmbeddingRebuildRequiredError: Existing collection embedding metadata does not match current configuration. Rebuild is required before using the current embedding model.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
2026-05-28 08:03:21,504 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:21,504 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
/app/.venv/bin/python: Error while finding module specification for 'openviking.console.bootstrap' (ModuleNotFoundError: No module named 'openviking.console')
2026-05-28 08:03:28,636 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:28,636 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:29.211 | INFO     | openviking.telemetry.tracer:init_tracer_from_server_config:149 - [TRACER] disabled in server.observability.traces
[05/28/26 08:03:29] INFO     StreamableHTTP       streamable_http_manager.py:128
                             session manager                                    
                             started                                            
OpenViking HTTP Server is running on 0.0.0.0:1933
2026-05-28 08:03:30,733 - openviking.server.app - ERROR - Deferred initialization failed, exiting
Traceback (most recent call last):
  File "/app/.venv/lib/python3.13/site-packages/openviking/server/app.py", line 177, in _deferred_init
    await service.initialize()
  File "/app/.venv/lib/python3.13/site-packages/openviking/service/core.py", line 272, in initialize
    await init_context_collection(self._vikingdb_manager)
  File "/app/.venv/lib/python3.13/site-packages/openviking/storage/collection_schemas.py", line 290, in init_context_collection
    raise EmbeddingRebuildRequiredError(
    ...<2 lines>...
    )
openviking.storage.errors.EmbeddingRebuildRequiredError: Existing collection embedding metadata does not match current configuration. Rebuild is required before using the current embedding model.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
2026-05-28 08:03:32,533 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:32,534 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
/app/.venv/lib/python3.13/site-packages/requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.7.0) or chardet (7.0.1)/charset_normalizer (3.4.5) doesn't match a supported version!
  warnings.warn(
/app/.venv/bin/python: Error while finding module specification for 'openviking.console.bootstrap' (ModuleNotFoundError: No module named 'openviking.console')
2026-05-28 08:03:39,540 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.port' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:39,540 - openviking_cli.utils.config.agfs_config - WARNING - AGFSConfig: 'storage.agfs.log_level' is deprecated and ignored after the RAGFS migration.
2026-05-28 08:03:40.099 | INFO     | openviking.telemetry.tracer:init_tracer_from_server_config:149 - [TRACER] disabled in server.observability.traces
[05/28/26 08:03:40] INFO     StreamableHTTP       streamable_http_manager.py:128
                             session manager                                    
                             started                                            
OpenViking HTTP Server is running on 0.0.0.0:1933
2026-05-28 08:03:41,171 - openviking.server.app - ERROR - Deferred initialization failed, exiting
Traceback (most recent call last):
  File "/app/.venv/lib/python3.13/site-packages/openviking/server/app.py", line 177, in _deferred_init
    await service.initialize()
  File "/app/.venv/lib/python3.13/site-packages/openviking/service/core.py", line 272, in initialize

OpenViking Version

V0.3.19/20/21

Python Version

官方docker安装。

Operating System

Linux

Model Backend

None

Additional Context

No response

[walnut-tom]

直接起不来了，这个要加急呀

[chinarma]

我也遇到同样的问题，空数据的情况是没有问题的，但如果 workspace 里有原始数据，就报这个错误

[chinarma]

研究后，发现可以删除workspace里的向量目录下的所有文件后，然后再启动，可以成功升级到0.3.21

[ZaynJarvis]

这问题只是之前的 web console 被替换导致的。bootstrap console not found. 改下 “python -m openviking.console.bootstrap --host 0.0.0.0 --port 8020 --openviking-url http://127.0.0.1:1933 --write-enabled” 这段去掉能恢复。待会让 agent review 下给你个具体的 plan

[ZaynJarvis]

看了一下日志，这里是两个问题叠在一起了：

1. 新版本里 openviking.console.bootstrap 已经不存在，所以 Docker command 里的这段需要去掉：
   python -m openviking.console.bootstrap ...
   先只启动 openviking-server，确认主服务能起来。

2. 后面的 EmbeddingRebuildRequiredError 是另一个问题：已有 context 向量集合的 embedding metadata 和当前 embedding 配置不一致。升级时需要重建/清理向量索引；建议先备份数据，再处理 vectordb/context，不要直接删业务数据。

麻烦确认一下：去掉 console bootstrap 后，是否只剩 EmbeddingRebuildRequiredError？如果是，这个 issue 我们就收敛成“升级时 embedding index 重建/迁移说明不清楚”，再补具体迁移文档。