> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/5/iagctl/create-registry/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# iagctl create registry

Create a new dependency management registry.

The `iagctl create registry` command creates a registry in your gateway's data store. You can create registries that point to private PyPI and Ansible Galaxy registries for use with your Python and Ansible services.

By default, Gateway includes a PyPI registry called `default-pypi` that points to the public PyPI registry and an Ansible Galaxy registry called `default-galaxy` that points to the public Ansible Galaxy registry. For more information, see [Create an Ansible Galaxy registry](/itential-gateway/5/iagctl/create-registry#create-an-ansible-galaxy-registry).

## Syntax

```bash
iagctl create registry <type> <registry-name> [flags]
```

## Handle secret values

Use the `--password-name` and `--token-name` flags to reference secret resources that contain password or token values. This approach ensures that Gateway doesn't store the password or token in plain text within the registry.

For example, to create a registry that requires a token:

1. Configure your [Gateway secret store](/itential-gateway/5/configure-secret-store) with an encryption file.
2. Create a secret that contains the token value:

```bash
   iagctl create secret my-pypi-token --value 'my-token-value'
```

3. Create a registry with the `--token-name` flag:

```bash
   iagctl create registry pypi my-pypi-registry \
   --url 'http://private-repo-hostname' \
   --token-name my-pypi-token
```

The registry `my-pypi-registry` now references the secret `my-pypi-token` for its token value. Gateway decrypts the token at runtime when you run a service that requires the registry.

For more information about creating secret resources, see [iagctl create secret](/itential-gateway/5/iagctl/create-secret).

## Examples

### Create a PyPI registry

The following example creates a basic PyPI registry called `my-pypi-registry`:

```bash
iagctl create registry pypi my-pypi-registry \
--url 'http://repo-hostname:8080/simple'
```

For more information about PyPI registries, run `iagctl create registry pypi --help`.

### Create an Ansible Galaxy registry

The following example creates a basic Ansible Galaxy registry called `my-galaxy-registry`:

```bash
iagctl create registry ansible-galaxy my-galaxy-registry \
--url 'http://repo-hostname:8080'
```

For more information about Ansible Galaxy registries, run `iagctl create registry ansible-galaxy --help`.

## Options

```bash
  -h, --help   Help for registry
```

## Options inherited from parent commands

```bash
  --profile string   Specify the client profile to use (case-insensitive, defaults to [client] section)
  --config string   Path to the configuration file
  --raw             Display the result of the command in raw format
  --verbose         Enable verbose output
```