# registry-keys

> Pull private images by storing your registry logins once.

The `registry-keys` commands add, list, change and remove your organization's registry credentials.

```bash
featherless-cloud registry-keys <subcommand> [options]
```

Registry credentials belong to the organization. Only owners and admins can add, change or remove them. See [Registry credentials](/get-started/credentials#add-registry-credentials).

## List credentials

```bash
featherless-cloud registry-keys list
```

## Add a credential

```bash
featherless-cloud registry-keys add ghcr --server ghcr.io --username my-user
echo "$GHCR_TOKEN" | featherless-cloud registry-keys add ghcr --server ghcr.io --username my-user --password-stdin
```

Without `--password-stdin`, the CLI prompts for the password or access token. Then use the credential by name:

```bash
featherless-cloud exec --image ghcr.io/my-user/train:1 --registry ghcr -- python train.py
```

<table>
<thead>
  <tr>
    <th>
      Option
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --server <host>
      </code>
    </td>
    
    <td>
      Registry host, such as <code>
        docker.io
      </code>
      
       or <code>
        ghcr.io
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --username <user>
      </code>
    </td>
    
    <td>
      Registry username.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --password-stdin
      </code>
    </td>
    
    <td>
      Read the password or access token from standard input.
    </td>
  </tr>
</tbody>
</table>

## Change a credential

```bash
featherless-cloud registry-keys update ghcr --change-password
```

<table>
<thead>
  <tr>
    <th>
      Option
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --name <name>
      </code>
    </td>
    
    <td>
      New name.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --server <host>
      </code>
    </td>
    
    <td>
      New registry host.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --username <user>
      </code>
    </td>
    
    <td>
      New username.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --change-password
      </code>
    </td>
    
    <td>
      Prompt for a new password or access token.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --password-stdin
      </code>
    </td>
    
    <td>
      Read a new password or access token from standard input.
    </td>
  </tr>
</tbody>
</table>

## Remove a credential

```bash
featherless-cloud registry-keys delete ghcr
```

A credential that instances use can't be removed.

<table>
<thead>
  <tr>
    <th>
      Option
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --yes
      </code>
    </td>
    
    <td>
      Skip the confirmation.
    </td>
  </tr>
</tbody>
</table>
