hyperledger/fabric · error

cannot define a new channel with no Application section

Error message

cannot define a new channel with no Application section

What it means

NewChannelCreateConfigUpdate builds the ConfigUpdate transaction used to create a new application channel. It refuses to proceed when the profile has no Application section, because a new channel must define application orgs and capabilities. This is a deliberate guard against generating a channel-creation transaction from an incomplete profile.

Source

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

	for _, org := range conf.Organizations {
		var err error
		consortiumGroup.Groups[org.Name], err = NewConsortiumOrgGroup(org)
		if err != nil {
			return nil, errors.Wrap(err, "failed to create consortium org")
		}
	}

	addValue(consortiumGroup, channelconfig.ChannelCreationPolicyValue(policies.ImplicitMetaAnyPolicy(channelconfig.AdminsPolicyKey).Value()), ordererAdminsPolicyName)

	consortiumGroup.ModPolicy = ordererAdminsPolicyName
	return consortiumGroup, nil
}

// NewChannelCreateConfigUpdate generates a ConfigUpdate which can be sent to the orderer to create a new channel.  Optionally, the channel group of the
// ordering system channel may be passed in, and the resulting ConfigUpdate will extract the appropriate versions from this file.
func NewChannelCreateConfigUpdate(channelID string, conf *genesisconfig.Profile, templateConfig *cb.ConfigGroup) (*cb.ConfigUpdate, error) {
	if conf.Application == nil {
		return nil, errors.New("cannot define a new channel with no Application section")
	}

	if conf.Consortium == "" {
		return nil, errors.New("cannot define a new channel with no Consortium value")
	}

	newChannelGroup, err := NewChannelGroup(conf)
	if err != nil {
		return nil, errors.Wrapf(err, "could not turn parse profile into channel group")
	}

	updt, err := update.Compute(&cb.Config{ChannelGroup: templateConfig}, &cb.Config{ChannelGroup: newChannelGroup})
	if err != nil {
		return nil, errors.Wrapf(err, "could not compute update")
	}

	// Add the consortium name to create the channel for into the write set as required.
	updt.ChannelId = channelID

View on GitHub (pinned to 2736b63f8f)

Solutions

1. Add an Application section (with Organizations and Capabilities) to the profile used for channel creation.
2. Point --profile at an application-channel profile, not the system channel/orderer-only profile.
3. Confirm configtx.yaml profile indentation so Application is actually parsed into the profile.

Example fix

# before
Profile:
  MyChannel:
    Orderer:
      OrdererDefaults
# after
Profile:
  MyChannel:
    Orderer:
      OrdererDefaults
    Application:
      Organizations:
        - *Org1
      Capabilities:
        V1_4: true

if profile.Application == nil || len(profile.Application.Organizations) == 0 {
    return errors.New("profile must define an Application section with organizations before channel creation")
}

func hasApplicationSection(p *genesisconfig.Profile) bool {
    return p != nil && p.Application != nil
}

_, err := encoder.NewChannelCreateConfigUpdate(channelID, profile, template)
if err != nil && strings.Contains(err.Error(), "no Application section") {
    return fmt.Errorf("use an application-channel profile for %s", channelID)
}

When it happens

Trigger: Calling NewChannelCreateConfigUpdate or MakeChannelCreationTransactionFromTemplate with a genesisconfig.Profile where conf.Application == nil (e.g. using an orderer-only/system-channel-style profile for channel creation).

Common situations: Using `configtxgen --outputCreateChannelTx` with a profile that only defines Orderer settings; copying a system channel profile as the channel-creation profile; edits where the Application block was deleted from the profile.

Related errors

• cannot define a new channel with no Consortium value
• could not turn parse profile into channel group
• could not compute update
• Attempted to set the batch size max message count to an inva
• Attempted to set the batch size absolute max bytes to an inv

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