Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[WEBJS] - Multiple sessions keep bouncing between STARTING and FAILED after container restart (v2026.9.2, WEBJS)

Open
  • Is something wrong?
#2,315 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 2 days

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
48/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
node.js, typescript
Domain
api, backend

Research direction

Start by reproducing the issue with multiple WEBJS sessions after restarting the container, then inspect the session startup and failure handling entry points. The report does not name files or tests, and the promised Docker logs are not included, so use the logs to locate where statuses alternate between STARTING and FAILED. Done means sessions reach a stable WORKING or SCAN_QR_CODE state after restart.

Written by the indexing model from the issue text.

Description

bug
Describe the bug

When I restart the container, several sessions never finish starting. Their status keeps alternating between STARTING and FAILED, bouncing back and forth. This happens consistently after a container restart.

Version

Get the WAHA version by calling GET /api/version

{
  "version": "2026.9.2",
  "engine": "WEBJS",
  "tier": "UNKNOWN"
}

Replace UNKNOWN with the actual tier returned by GET /api/version if needed.

Try to update to
the latest version before
creating an issue!

Steps

To Reproduce Steps to reproduce the behavior:

  1. Restart the WAHA container.
  2. Wait for the sessions to initialize.
  3. Observe several sessions.
  4. The sessions keep switching between STARTING and FAILED.
Expected behavior

After restarting the container, all sessions should start normally and reach a stable state, such as WORKING or SCAN_QR_CODE if QR scanning is required. They should not repeatedly flip between STARTING and FAILED.

Requests - Responses

N/A / I can provide request and response details if needed.

Docker Logs

I will attach the related Docker logs below.
https://waha.devlike.pro/docs/how-to/deploy/#viewing-the-logs

Screenshots

N/A

Additional context
  • Version: 2026.9.2
  • Engine: WEBJS
  • The issue occurs when restarting the container.
  • Multiple sessions are affected.
  • The status keeps bouncing back and forth between STARTING and FAILED.
Dominant language
TypeScript
Stars
7.6k
Forks
1.8k
Avg merge
2d 21h
Merged PRs (30d)
7

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from devlikeapro/waha

All issues in devlikeapro/waha

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.