> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# anaconda repo channel

export const GCell = ({children, className}) => <div className={`grid-table-cell ${className || ""}`} role="cell">
    {children}
  </div>;

export const GTH = ({children, className}) => <div className={`grid-table-th ${className || ""}`} role="columnheader">
    {children}
  </div>;

export const GRow = ({children}) => <div className="grid-table-row" role="row">{children}</div>;

export const GBody = ({children}) => <div className="grid-table-body" role="rowgroup">{children}</div>;

export const GHead = ({children}) => <div className="grid-table-head" role="rowgroup">{children}</div>;

export const GTable = ({children, className, cols}) => <div className={`grid-table not-prose overflow-hidden rounded-2xl ${className || ""}`} style={{
  "--grid-table-cols": cols
}} role="table">
    {children}
  </div>;

export const Comments = ({children}) => {
  return <div class="my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border border-zinc-500/20 bg-zinc-50/50 dark:border-zinc-500/30 dark:bg-zinc-500/10" data-callout-type="comments">
      <div class="w-4">
        <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" xmlns="http://www.w3.org/2000/svg" class="w-5 h-5" aria-label="Comments">
            <path d="M320 112C434.9 112 528 205.1 528 320C528 434.9 434.9 528 320 528C205.1 528 112 434.9 112 320C112 205.1 205.1 112 320 112zM320 576C461.4 576 576 461.4 576 320C576 178.6 461.4 64 320 64C178.6 64 64 178.6 64 320C64 461.4 178.6 576 320 576zM280 400C266.7 400 256 410.7 256 424C256 437.3 266.7 448 280 448L360 448C373.3 448 384 437.3 384 424C384 410.7 373.3 400 360 400L352 400L352 312C352 298.7 341.3 288 328 288L280 288C266.7 288 256 298.7 256 312C256 325.3 266.7 336 280 336L304 336L304 400L280 400zM320 256C337.7 256 352 241.7 352 224C352 206.3 337.7 192 320 192C302.3 192 288 206.3 288 224C288 241.7 302.3 256 320 256z" />
        </svg>
      </div>
      <div class="text-sm prose min-w-0 w-full">
        {children}
      </div>
    </div>;
};

## Usage

```bash theme={null}
anaconda repo channel [OPTIONS]
```

## Description

Manages repository channels and subchannels: list channels, create or remove a channel, show channel details, list packages or files, view history, and change privacy (lock/unlock) or indexing (freeze/unfreeze). Exactly one action must be specified.

### Subchannels

A subchannel is a hierarchical division within an existing channel, referenced using the `<CHANNEL>/<SUBCHANNEL>` syntax. Subchannels operate independently from the parent channel—they can have their own mirroring configurations, privacy settings, and policies.

<Note>
  Most `channel` actions that accept a `<CHANNEL>` argument also work with subchannels by specifying the full path.
</Note>

## Options

<GTable cols="25% 25% 50%">
  <GHead>
    <GRow>
      <GTH>Option</GTH>
      <GTH>Default</GTH>
      <GTH>Description</GTH>
    </GRow>
  </GHead>

  <GBody>
    <GRow>
      <GCell>`--list`</GCell>

      <GCell />

      <GCell>List all channels for the user</GCell>
    </GRow>

    <GRow>
      <GCell>`--create <CHANNEL>`</GCell>

      <GCell />

      <GCell>Create a new channel</GCell>
    </GRow>

    <GRow>
      <GCell>`--remove <CHANNEL>`</GCell>

      <GCell />

      <GCell>Remove a channel</GCell>
    </GRow>

    <GRow>
      <GCell>`--show <CHANNEL>`</GCell>

      <GCell />

      <GCell>Show information about the channel</GCell>
    </GRow>

    <GRow>
      <GCell>`--list-packages <CHANNEL> [ ... ]`</GCell>

      <GCell />

      <GCell>List packages in one or more channels</GCell>
    </GRow>

    <GRow>
      <GCell>`--history <CHANNEL>`</GCell>

      <GCell />

      <GCell>Show historical events for the channel</GCell>
    </GRow>

    <GRow>
      <GCell>`--package-changes <CHANNEL>`</GCell>

      <GCell />

      <GCell>Show package addition/removal history</GCell>
    </GRow>

    <GRow>
      <GCell>`--lock <CHANNEL>`</GCell>

      <GCell />

      <GCell>Lock channel (make private)</GCell>
    </GRow>

    <GRow>
      <GCell>`--soft-lock <CHANNEL>`</GCell>

      <GCell />

      <GCell>Soft-lock (authenticated users only)</GCell>
    </GRow>

    <GRow>
      <GCell>`--unlock <CHANNEL>`</GCell>

      <GCell />

      <GCell>Unlock channel (make public)</GCell>
    </GRow>

    <GRow>
      <GCell>`--freeze <CHANNEL>`</GCell>

      <GCell />

      <GCell>Freeze channel (prevent indexing updates)</GCell>
    </GRow>

    <GRow>
      <GCell>`--unfreeze <CHANNEL>`</GCell>

      <GCell />

      <GCell>Unfreeze channel (allow indexing updates)</GCell>
    </GRow>

    <GRow>
      <GCell>`-o, --offset <#>`</GCell>
      <GCell>`0`</GCell>
      <GCell>Offset when displaying results</GCell>
    </GRow>

    <GRow>
      <GCell>`-l, --limit <#>`</GCell>
      <GCell>`50`</GCell>
      <GCell>Limit when displaying results</GCell>
    </GRow>

    <GRow>
      <GCell>`--full-details`</GCell>

      <GCell />

      <GCell>Show full details (for example, for `list-packages`, `show`)</GCell>
    </GRow>

    <GRow>
      <GCell>`-h, --help`</GCell>

      <GCell />

      <GCell>Show help for this command</GCell>
    </GRow>
  </GBody>
</GTable>

## Examples

**List your channels**

```bash theme={null}
anaconda repo channel --list
```

**Create a new channel**

```bash theme={null}
anaconda repo channel --create <CHANNEL>
```

<Comments>
  Replace \<CHANNEL> with a name for the channel you want to create.
</Comments>

**Show channel details**

```bash theme={null}
anaconda repo channel --show <CHANNEL> --full-details
```

<Comments>
  Replace \<CHANNEL> with the name of the channel you want to view details for.
</Comments>

**List packages in a channel**

```bash theme={null}
anaconda repo channel --list-packages <CHANNEL> 
```

<Comments>
  Replace \<CHANNEL> with the name of the channel you want to view packages for.
</Comments>

**Make a channel private**

```bash theme={null}
anaconda repo channel --lock <CHANNEL>
```

<Comments>
  Replace \<CHANNEL> with the name of the channel you want to make private.
</Comments>

**Freeze a channel (stop indexing updates)**

```bash theme={null}
anaconda repo channel --freeze <CHANNEL>
```

<Comments>
  Replace \<CHANNEL> with the name of the channel you want to freeze.
</Comments>

**Show history for a channel**

```bash theme={null}
anaconda repo channel --history <CHANNEL>
```

<Comments>
  Replace \<CHANNEL> with the name of the channel you want to view history for.
</Comments>

**Show package changes for a channel**

```bash theme={null}
anaconda repo channel --package-changes <CHANNEL>
```

<Comments>
  Replace \<CHANNEL> with the name of the channel you want to view package changes for.
</Comments>

### Subchannel examples

**Create a subchannel within an existing channel**

```bash theme={null}
anaconda repo channel --create <CHANNEL>/<SUBCHANNEL>
```

<Comments>
  Replace \<CHANNEL> with the name of the channel you want to create a subchannel in, and \<SUBCHANNEL> with the name of the subchannel you want to create.
</Comments>

**Show subchannel details**

```bash theme={null}
anaconda repo channel --show <CHANNEL>/<SUBCHANNEL> --full-details
```

<Comments>
  Replace \<CHANNEL> with the name of the channel that contains the subchannel you want to view details for, and \<SUBCHANNEL> with the name of the subchannel you want to view details for.
</Comments>

**List packages in a subchannel**

```bash theme={null}
anaconda repo channel --list-packages <CHANNEL>/<SUBCHANNEL>
```

<Comments>
  Replace \<CHANNEL> with the name of the channel that contains the subchannel you want to list packages for, and \<SUBCHANNEL> with the name of the subchannel you want to list packages for.
</Comments>

**Lock a subchannel (make it private)**

```bash theme={null}
anaconda repo channel --lock <CHANNEL>/<SUBCHANNEL>
```

<Comments>
  Replace \<CHANNEL> with the name of the channel that contains the subchannel you want to view details for, and \<SUBCHANNEL> with the name of the subchannel you want to view details for.
</Comments>

**Remove a subchannel**

```bash theme={null}
anaconda repo channel --remove <CHANNEL>/<SUBCHANNEL>
```

<Comments>
  Replace \<CHANNEL> with the name of the channel that contains the subchannel you want to remove, and \<SUBCHANNEL> with the name of the subchannel you want to remove.
</Comments>