hyperledger/fabric · error

could not create orderer group

Error message

could not create orderer group

What it means

Wrapping error in NewChannelGroup: NewOrdererGroup failed while building the orderer section of the channel config. Typically caused by invalid orderer organization config, MSP load failure, or policy errors within the orderer group; the wrapped error carries the specifics.

Source

Thrown at internal/configtxgen/encoder/encoder.go:160

	addValue(channelGroup, channelconfig.HashingAlgorithmValue(), channelconfig.AdminsPolicyKey)
	addValue(channelGroup, channelconfig.BlockDataHashingStructureValue(), channelconfig.AdminsPolicyKey)
	if conf.Orderer != nil && len(conf.Orderer.Addresses) > 0 {
		addValue(channelGroup, channelconfig.OrdererAddressesValue(conf.Orderer.Addresses), ordererAdminsPolicyName)
	}

	if conf.Consortium != "" {
		addValue(channelGroup, channelconfig.ConsortiumValue(conf.Consortium), channelconfig.AdminsPolicyKey)
	}

	if len(conf.Capabilities) > 0 {
		addValue(channelGroup, channelconfig.CapabilitiesValue(conf.Capabilities), channelconfig.AdminsPolicyKey)
	}

	var err error
	if conf.Orderer != nil {
		channelGroup.Groups[channelconfig.OrdererGroupKey], err = NewOrdererGroup(conf.Orderer, conf.Capabilities)
		if err != nil {
			return nil, errors.Wrap(err, "could not create orderer group")
		}
	}

	if conf.Application != nil {
		channelGroup.Groups[channelconfig.ApplicationGroupKey], err = NewApplicationGroup(conf.Application)
		if err != nil {
			return nil, errors.Wrap(err, "could not create application group")
		}
	}

	if conf.Consortiums != nil {
		channelGroup.Groups[channelconfig.ConsortiumsGroupKey], err = NewConsortiumsGroup(conf.Consortiums)
		if err != nil {
			return nil, errors.Wrap(err, "could not create consortiums group")
		}
	}

	channelGroup.ModPolicy = channelconfig.AdminsPolicyKey

View on GitHub (pinned to 2736b63f8f)

Solutions

1. Follow the wrapped error: fix the orderer organizations, MSP directories, or policies in the profile's Orderer section
2. Verify each orderer org's MSPDir exists and contains valid signing/CA material
3. Check that orderer capability and consensus type settings are consistent

When it happens

Trigger: Thrown at internal/configtxgen/encoder/encoder.go:160 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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