specified --channelID %s does not match channel ID %s in con

Error message

specified --channelID %s does not match channel ID %s in config update envelope

What it means

validateEnvelopeChannelID checks that the channel ID embedded in the config update envelope equals --channelID. A mismatch means you're applying an update for a different channel than the one named on the command line.

Source

Thrown at cmd/osnadmin/main.go:246

	return nil
}

func validateEnvelopeChannelID(envelopeBytes []byte, channelID string) error {
	envelope := &common.Envelope{}
	err := proto.Unmarshal(envelopeBytes, envelope)
	if err != nil {
		return fmt.Errorf("unmarshalling envelope: %s", err)
	}

	envelopeChannelID, err := protoutil.GetChannelIDFromEnvelope(envelope)
	if err != nil {
		return err
	}

	// quick sanity check that the orderer admin is joining
	// the channel they think they're joining.
	if channelID != envelopeChannelID {
		return fmt.Errorf("specified --channelID %s does not match channel ID %s in config update envelope", channelID, envelopeChannelID)
	}

	return nil
}

View on GitHub (pinned to 2736b63f8f)

Solutions

Make --channelID match the envelope's embedded channel ID.
Regenerate the envelope with configtxgen using the correct --channelID.
Re-export/re-select the correct envelope file.
Check for case-sensitivity or whitespace in --channelID.

Example fix

// before
osnadmin channel update --channelID channel1 --configUpdateEnvelope channel2_anchor.pb
// after
osnadmin channel update --channelID channel2 --configUpdateEnvelope channel2_anchor.pb

Defensive patterns

Strategy: validation

Validate before calling

// verify envelope channel before update
env := &common.Envelope{}
if err := proto.Unmarshal(envBytes, env); err != nil { return err }
envCh, err := protoutil.GetChannelIDFromEnvelope(env)
if err != nil { return err }
if envCh != targetChannelID {
    return fmt.Errorf("envelope is for %s, want %s", envCh, targetChannelID)
}

Try / catch

if err := runOsnadmin(); err != nil {
    if strings.Contains(err.Error(), "does not match channel ID") {
        log.Fatalf("--channelID disagrees with envelope contents: %v", err)
    }
}

Prevention

Pass the same --channelID to configtxgen and osnadmin.
Store envelopes per-channel in separate directories.
Check channel ID case-sensitivity.
Re-generate anchor-peer updates when adding channels.

When it happens

Trigger: `osnadmin channel update --channelID A --configUpdateEnvelope <envelope for channel B>`.

Common situations: Reusing an anchor-peer update envelope from another channel, editing --channelID by hand, or generating the envelope with the wrong --channelID passed to configtxgen.

Related errors

AI-assisted analysis of hyperledger/fabric@2736b63f8f (2026-09-04). Data as JSON: /api/errors/73fc675b970d0113. Report an issue: GitHub.