---
title: snrd auth register
description: Register a new decentralized identity using WebAuthn/Passkey authentication
---

# snrd auth register

Register a new decentralized identity using WebAuthn/Passkey authentication.

This command will:
1. Start a local auth server
2. Open your browser for WebAuthn credential creation
3. Create a DID document with your WebAuthn credential
4. Auto-create a DWN vault for data storage

## Usage

```shell
snrd auth register [flags]
```

## Flags

<ParamField path="username" type="string" required>
  Username for the new identity
</ParamField>

<ParamField path="auto-vault" type="boolean" default="true">
  Automatically create vault for DID
</ParamField>

<ParamField path="webauthn" type="boolean" default="true">
  Use WebAuthn for registration
</ParamField>

<ParamField path="help" type="boolean">
  Help for register
</ParamField>

## Global Flags

<ParamField path="broadcast-mode" type="string" default="sync">
  Transaction broadcasting mode (sync|async)
</ParamField>

<ParamField path="chain-id" type="string">
  Specify Chain ID for sending Tx
</ParamField>

<ParamField path="fees" type="string">
  Fees to pay along with transaction (e.g., 10aatom)
</ParamField>

<ParamField path="from" type="string">
  Name or address of private key with which to sign
</ParamField>

<ParamField path="gas-adjustment" type="float" default="1">
  Adjustment factor to be multiplied against the estimate returned by the tx simulation
</ParamField>

<ParamField path="gas-prices" type="string">
  Gas prices to determine the transaction fee (e.g., 10aatom)
</ParamField>

<ParamField path="home" type="string" default="~/.sonr">
  Directory for config and data
</ParamField>

<ParamField path="keyring-backend" type="string" default="os">
  Select keyring's backend
</ParamField>

<ParamField path="log_format" type="string" default="plain">
  The logging format (json|plain)
</ParamField>

<ParamField path="log_level" type="string" default="info">
  The logging level
</ParamField>

<ParamField path="log_no_color" type="boolean">
  Disable colored logs
</ParamField>

<ParamField path="node" type="string" default="tcp://localhost:26657">
  Tendermint RPC interface for this chain
</ParamField>

<ParamField path="trace" type="boolean">
  Print out full stack trace on errors
</ParamField>

## Examples

### Basic registration

```shell
snrd auth register --username alice
```

### Registration without auto vault creation

```shell
snrd auth register --username alice --auto-vault=false
```

### Registration with custom chain ID

```shell
snrd auth register --username alice --chain-id sonrtest_1-1
```

## See Also

- [snrd auth](./snrd_auth.mdx) - User authentication with Passkeys
- [snrd auth login](./snrd_auth_login.mdx) - Login with WebAuthn authentication