hashicorp/nomad · error

%s %q was not found in the Raft configuration

Error message

%s %q was not found in the Raft configuration

What it means

TransferLeadershipToPeer could not match the supplied server ID or address against any server in the current Raft configuration, so it refuses to initiate a leadership transfer to an unknown peer.

Source

Thrown at nomad/operator_endpoint.go:281

	if err := future.Error(); err != nil {
		reply.Err = err
		return err
	}

	// Since this is an operation designed for humans to use, we will return
	// an error if the supplied ID or address isn't among the peers since it's
	// likely a mistake.
	var found bool
	for _, s := range future.Configuration().Servers {
		if s.ID == req.ID || s.Address == req.Address {
			reply.To = structs.NewRaftIDAddress(s.Address, s.ID)
			found = true
			break
		}
	}

	if !found {
		reply.Err = fmt.Errorf("%s %q was not found in the Raft configuration",
			kind, testedVal)
		return structs.NewErrRPCCoded(http.StatusBadRequest, reply.Err.Error())
	}

	// Otherwise, this is a no-op, respond accordingly.
	if reply.From == reply.To {
		op.logger.Debug("leadership transfer to current leader is a no-op")
		reply.Noop = true
		return nil
	}

	log := op.logger.With(
		"to_peer_id", reply.To.ID, "to_peer_addr", reply.To.Address,
		"from_peer_id", reply.From.ID, "from_peer_addr", reply.From.Address,
	)
	if err = op.srv.leadershipTransferToServer(reply.To); err != nil {
		reply.Err = err
		log.Error("failed transferring leadership", "error", reply.Err.Error())

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Run `nomad operator raft list-peers` and pass an exact ID or address from that list
2. Verify the region and API endpoint target the intended cluster
3. Retry with the canonical form of the peer address shown by the CLI

When it happens

Trigger: Thrown at nomad/operator_endpoint.go:281 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/db6181f909c74d35. Report an issue: GitHub.