portainer/portainer · error

no nodes available

Error message

no nodes available

What it means

Error "no nodes available" thrown in portainer/portainer.

Source

Thrown at api/stacks/deployments/deployer_remote.go:375

	}

	info, err := cli.Info(ctx)
	if err != nil {
		return nil, errors.Wrap(err, "unable to get agent info")
	}

	if isNotInASwarm(&info) {
		return cli, nil
	}
	defer logs.CloseAndLogErr(cli)

	nodes, err := cli.NodeList(ctx, types.NodeListOptions{})
	if err != nil {
		return nil, errors.Wrap(err, "unable to list nodes")
	}

	if len(nodes) == 0 {
		return nil, errors.New("no nodes available")
	}

	var managerNode swarm.Node
	for _, node := range nodes {
		if node.ManagerStatus != nil && node.ManagerStatus.Leader {
			managerNode = node
			break
		}
	}

	if managerNode.ID == "" {
		return nil, errors.New("no leader node available")
	}

	return d.ClientFactory.CreateClient(endpoint, managerNode.Description.Hostname, &timeout)
}

func (d *stackDeployer) unpackerImageRegistryAuth(unpackerImg string) (string, error) {

View on GitHub (pinned to 17e74456ff)

When it happens

Trigger: Thrown at api/stacks/deployments/deployer_remote.go:375 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of portainer/portainer@17e74456ff (2026-08-26). Data as JSON: /api/errors/becce2b69207981d. Report an issue: GitHub.