Creating and Editing Channels

There are three default channels that can be edited or archived. You can also add custom channels.

The default channels are:

• Stable: The Stable channel is intended for production installations.
• Unstable: The Unstable channel is intended for internal testing.
• Beta: The Beta channel is intended for release candidates and early adopting customers.

For more information, see About Channels and Releases.

Create a Channel

To create a channel:

1. From the Replicated vendor portal, select Channels from the left menu.

2. Click Create Channel.

   The Create a new channel dialog opens. For example:

   

3. Enter a name and description for the channel.

4. (KOTS Only) For applications that support installation with Replicated KOTS, to enable semantic versioning on the channel if it is not enabled by default, turn on Enable semantic versioning. For more information about semantic versioning and defaults, see Semantic Versioning.

5. (KOTS Only) For applications that support installation with KOTS, to enable an air gap bundle format that supports image digests and deduplication of image layers, turn on Enable new air gap bundle format. For more information, see Using Image Tags and Digests.

6. Click Create Channel.

Edit a Channel

To edit the settings of an existing channel:

1. In the vendor portal, select Channels from the left menu.

2. Click the gear icon on the top right of the channel that you want to modify.

   The Channel settings dialog opens. For example:

   

3. Edit the fields and click Save.

   For more information about channel settings, see Settings in About Channels and Releases.

Archive a Channel

You can archive an existing channel to prevent any new releases from being promoted to the channel.

note

You cannot archive a channel if:

• There are customers assigned to the channel.
• The channel is set as the default channel.

Assign customers to a different channel and set a different channel as the default before archiving.

To archive a channel with the vendor portal or the replicated CLI:

• Vendor portal: In the vendor portal, go to the Channels page and click the trash can icon in the top right corner of the card for the channel that you want to archive.

• replicated CLI:

  1. Run the following command to find the ID for the channel that you want to archive:

     replicated channel ls

     The output of this command includes the ID and name for each channel, as well as information about the latest release version on the channels.

  2. Run the following command to archive the channel:

     replicated channel rm CHANNEL_ID

     Replace CHANNEL_ID with the channel ID that you retrieved in the previous step.

     For more information, see channel delete in the replicated CLI documentation.