#3828·arcane

Bug: Edge agent Easy-Join Swarm cluster fails with no output error

Author: connoravoCreated Sep 2, 2026Updated Sep 2, 2026
Labelstriage

Bug Description

Attempting to add an online edge note (connected over Tailscale) to a Swarm Cluster fails with Internal Server Error of no description.

Using v2.10.1 on both manager and agent.

Steps To Reproduce

  1. Create an edge node - Configured to be connected to the manager using it's Tailscale address.
  2. From the manager, create a cluster from scratch and attempt to easy-join the agent.
  3. From the environments page, attempt to easy-join the agent.

Expected Behavior

I expected the already connected and managed agent node to join the Swarm cluster with ease.

Actual Behavior

The following error is displayed within the join results table: Failed: unexpected status code 500: {"$schema":"http://localhost:3552/api/api/schemas/ErrorModel.json","title":"Internal Server Error","status":500,"detail":"Failed to join swarm"}

The Agent logs report ERR Internal Server Error method=POST path=/api/environments/0/swarm/join duration=4.111996ms status=500 with no further information. Due to the distroless containers, I'm unable to exec into the agent container to diagnose further.

Screenshots

No response

Arcane Version

v2.10.1

Installation Method

Docker Run

Environment Type

Both Local and Remote Agents

Database Type

PostgreSQL

Operating System

Linux

Docker Version

29.7.2

Browser & Version

No response

Relevant Logs or Error Messages

bash

Docker Compose Configuration

yaml
services:
  arcane-agent:
    image: ghcr.io/getarcaneapp/agent:{{ arcane_agent_version }}
    container_name: arcane-agent
    restart: unless-stopped
    logging:
      driver: local
    security_opt:
      - no-new-privileges:true
    mem_limit: 256m
    cpus: '0.5'
    environment:
      EDGE_AGENT: "true"
      EDGE_TRANSPORT: poll
      AGENT_TOKEN: "{{ arcane_agent_token }}"
      MANAGER_API_URL: "{{ arcane_manager_api_url }}"
    ports:
      - "{{ arcane_agent_port }}:3553"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - arcane-agent-data:/app/data

volumes:
  arcane-agent-data:

Environment Configuration (.env file)

bash

Additional Context

The edge agent is a Raspberry Pi 4, 4GB.