Skip to content

[Setup]: WhatsApp bridge npm install timeout too short (60s) on container startup #14980

@Nicthien

Description

@Nicthien

What's Going Wrong?

Description :
When starting the Hermes container on Unraid (and likely other NAS/slower systems), the WhatsApp bridge fails to install dependencies because the npm install timeout is hardcoded to 60 seconds.

Environment :

  • Platform: Unraid (Docker container)
  • Hermes version: latest

Error:

[Whatsapp] Installing WhatsApp bridge dependencies...
[Whatsapp] Failed to install dependencies: Command '['npm', 'install', '--silent']' timed out after 60 seconds
[Whatsapp] Disconnecting (external bridge left running)

Location: /opt/hermes/gateway/platforms/whatsapp.py line 387

Suggested fix:
Increase timeout from 60s to 300s (5 minutes), or make it configurable via environment variable.

Workaround:
Manual npm install inside the container after startup:
bash
docker exec -it hermes-agent sh -c 'cd /opt/hermes/scripts/whatsapp-bridge && npm install --verbose'

Steps Taken

  1. Updated Hermes Docker container on Unraid to latest version
  2. Container started, WhatsApp bridge attempted to auto-install dependencies
  3. npm install timed out after 60 seconds and bridge failed to start

Installation Method

Docker

Operating System

Unraid (Docker container)

Python Version

No response

Hermes Version

No response

Debug Report

Full Error Output

[Whatsapp] Installing WhatsApp bridge dependencies...
[Whatsapp] Failed to install dependencies: Command '['npm', 'install', '--silent']' timed out after 60 seconds
[Whatsapp] Disconnecting (external bridge left running)
[Whatsapp] Disconnected
[Whatsapp] Bridge process died (exit code 1)

What I've Already Tried

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium — degraded but workaround existsarea/dockerDocker image, Compose, packagingplatform/whatsappWhatsApp Business adaptertype/bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions