Skip to main content

​
Node Not Appearing in UI

​
Symptom

New worker node doesn’t show up in the Nodes dashboard.

​
Cause

  • Node not started
  • Network connectivity issue
  • Configuration mismatch
  • Port blocked by firewall

​
Fix

1

Verify Node Running

On the worker machine:
docker compose ps
docker compose logs backend
2

Check Network Connectivity

From worker to main:
ping 192.168.1.100
curl http://192.168.1.10:3100/health
3

Verify Configuration

Check .env on worker matches main node’s IP/hostname.

​
Jobs Not Distributing to Workers

​
Symptom

All jobs run on main node even with workers available.

​
Cause

  • Worker nodes marked as offline
  • Concurrent job limit reached
  • Queue assignment misconfigured

​
Fix

1

Check Node Status

In UI, verify worker nodes show as “Online” status.
2

Review Concurrent Limits

Settings → Jobs → Max Concurrent Jobs (must be >1 for distribution).
3

Check Assignment Logic

Jobs should auto-distribute based on node capacity.

​
Node Goes Offline Randomly

​
Symptom

Worker node shows as offline intermittently.

​
Cause

  • Network instability
  • Worker container crash
  • Heartbeat timeout too short
  • Resource exhaustion

​
Fix

1

Check Worker Logs

docker compose logs backend
2

Increase Heartbeat Interval

Adjust heartbeat timeout in settings if network is slow.
3

Monitor Resources

Check CPU/memory on worker: docker stats