# registry make

Create a new registry.config.json file

Canonical URL: https://docs.asterdoc.com/cli/commands/registry/make/

Create a new `registry.config.json` file, the source file of your own artifact registry.

## Usage

```bash
asterdoc registry make [directory] [options]
```

## Arguments

| Argument    | Description                                                  |
| ----------- | ------------------------------------------------------------ |
| `directory` | Directory to create registry in (default: current directory) |

## Options

| Option                        | Description                                   |
| ----------------------------- | --------------------------------------------- |
| `-n, --name <name>`           | Registry name                                 |
| `--description <description>` | Registry description                          |
| `--homepage <url>`            | Registry homepage URL                         |
| `--no-registry-telemetry`     | Disable usage telemetry for this registry     |
| `--no-directory`              | Do not list this registry in the Asterdoc Hub |
| `-y, --yes`                   | Skip confirmation prompts                     |

## Description

Creates `registry.config.json`, the file you list your artifact files in. This is the first step in hosting your own Asterdoc registry. [`registry compile`](/cli/commands/registry/compile) builds the registry from it: `registry.json` and a folder for each release. The command prompts for a name, description, and homepage interactively, or you can pass them via options. See [Registry config](/concepts/registries#registry-config) for every field.

## Examples

Create a registry interactively:

```bash
asterdoc registry make
```

Create in a specific directory with options:

```bash
asterdoc registry make ./my-registry \
  --name acme-forms \
  --description "Internal form templates" \
  --homepage https://acme.com/forms \
  -y
```

## Output

```
✓ Created registry.config.json

Name: acme-forms
Homepage: https://acme.com/forms
Description: Internal form templates

Next steps:
  1. Add artifacts with: asterdoc registry catalog add <artifact>
  2. Compile registry with: asterdoc registry compile
```

The new file has no source files yet:

```json
{
  "name": "acme-forms",
  "homepage": "https://acme.com/forms",
  "description": "Internal form templates",
  "enableTelemetry": true,
  "enableDirectory": true,
  "sources": []
}
```

## Next steps

After creating a registry:

1. Add artifacts with `asterdoc registry catalog add <artifact>`
2. Compile the registry with `asterdoc registry compile`
3. Deploy the compiled output to your hosting provider

## See also

* [registry catalog](/cli/commands/registry/catalog) - Manage catalog items
* [registry compile](/cli/commands/registry/compile) - Compile registry artifacts
* [Creating registries](/concepts/registries) - Full registry hosting guide