Docker 3.0.0-beta2: Missing 'utils' module crashes node_api_interface

[taker1988]

Step 1: Have you search for this issue before posting it?

Yes, I have searched the issue tracker and couldn't find a recent report about this specific missing module in the beta2 release.

Step 2: Describe your environment

• OS : Debian 13 (Host) running OctoBot via Docker (Portainer)
• Python Version: Python 3.13.15 (Inside the Docker container)
• In case you are not using a binary version:
  • Using Docker image drakkarsoftware/octobot:latest (which currently resolves to version 3.0.0-beta2)

Step 3: Describe the problem:

Describe the bug
After updating to the latest Docker image (Version 3.0.0-beta2), the container fails to load the web interface. The logs show a ModuleNotFoundError (No module named 'utils') for the node_api_interface tentacle, followed by an ImportError indicating a circular import for simple_market_making_trading_mode. Attempting to force reinstall the tentacles via python start.py tentacles --install --all or completely deleting the tentacles volume folder on the host does not resolve the issue, suggesting the base image itself is missing the utils module.

Expected behavior
The container should start cleanly, load all modules, and make the web interface accessible on port 5001 without crashing the node_api_interface.

Steps to reproduce:

1. Deploy or update to the drakkarsoftware/octobot:latest image via Docker / Portainer.
2. Start the container.
3. Check the container logs; the web interface fails to start and throws the ModuleNotFoundError.

Observed Results:

• What happened? The web interface is disabled, leading to a 502 Bad Gateway locally and an "Unavailable" status in the OctoBot Cloud.
• What did you expect to happen? The web interface should initialize correctly.

Relevant code exceptions or logs:

2026-09-02 06:23:31,993 INFO     OctoBot Launcher     Version : 3.0.0-beta2
2026-09-02 06:23:31,993 INFO     OctoBot Launcher     Running self-hosted OctoBot on Linux:6.12.107+deb13-amd64:x86_64 with binary [Python 3.13.15]
2026-09-02 06:23:33,436 ERROR    TentacleLoader       Error when loading node_api_interface: ModuleNotFoundError (No module named 'utils'). If this error persists, try reinstalling your tentacles via "python start.py tentacles --install --all".
2026-09-02 06:23:33,546 ERROR    TentacleLoader       Error when loading simple_market_making_trading_mode: ImportError (cannot import name 'node_api_interface' from partially initialized module 'tentacles.Services.Interfaces' (most likely due to a circular import) (/octobot/tentacles/Services/Interfaces/__init__.py)). If this error persists, try reinstalling your tentacles via "python start.py tentacles --install --all".
2026-09-02 06:23:33,592 INFO     OctoBot Launcher     Web interface disabled

[taker1988]

Hey, I figured it out. The crash happens because there are still old files left in the locally mapped tentacles volume after pulling the 3.0.0-beta2 image update.

You can fix this in two ways:

Option 1: Reinstall the tentacles inside the running container

sudo docker exec -it OctoBot python start.py tentacles --install --all
sudo docker restart OctoBot

Option 2: Clear the volume (Recommended)
Just wipe the mapped directory while the container is stopped. It downloads the correct files automatically when you start it again.

sudo docker stop OctoBot
sudo rm -rf /docker/container/OctoBot/tentacles/*
sudo docker start OctoBot

My docker-compose stack for reference

services:
  octobot:
    image: drakkarsoftware/octobot:latest
    container_name: OctoBot
    environment:
      - TZ=Europe/Berlin
      - UID=1000
      - GID=1000
    volumes:
      - /docker/container/OctoBot/user:/octobot/user:rw
      - /docker/container/OctoBot/tentacles:/octobot/tentacles:rw
      - /docker/container/OctoBot/logs:/octobot/logs:rw
    ports:
      - "8050:8000"
      - "5001:5001"
    restart: always
    security_opt:
      - no-new-privileges:true
    healthcheck:
      test: ["CMD-SHELL", "python3 -c 'import socket; s = socket.socket(socket.AF_INET, socket.SOCK_STREAM); s.settimeout(2); s.connect((\"localhost\", 8000)); s.close()' || exit 1"]
      interval: 1m
      timeout: 10s
      retries: 3
      start_period: 60s

Crash logs before applying the fix

2026-09-08 06:13:14,554 INFO     OctoBot Launcher     Loading config files...
2026-09-08 06:13:15,967 ERROR    TentacleLoader       Error when loading node_api_interface: ModuleNotFoundError (No module named 'utils'). If this error persists, try reinstalling your tentacles via "python start.py tentacles --install --all".
2026-09-08 06:13:16,077 ERROR    TentacleLoader       Error when loading simple_market_making_trading_mode: ImportError (cannot import name 'node_api_interface' from partially initialized module 'tentacles.Services.Interfaces' (most likely due to a circular import) (/octobot/tentacles/Services/Interfaces/__init__.py)). If this error persists, try reinstalling your tentacles via "python start.py tentacles --install --all".
2026-09-08 06:13:16,122 INFO     OctoBot Launcher     Web interface disabled