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

# idyl signup

> Create a new IDYL account

Authenticate with an IDYL realm and create a new account.

This command:

1. Sends a verification code to your email
2. Verifies the code to establish your identity
3. Prompts you to accept the terms and conditions
4. Creates a new account with you as the owner
5. Creates a context and saves your session

## Usage

```bash theme={null}
idyl signup [flags]
```

## Flags

| Flag                      | Description                                                                 |
| ------------------------- | --------------------------------------------------------------------------- |
| `--accept-terms`          | Accept the terms of service without the interactive prompt.                 |
| `--account-name <string>` | Name for the new account.                                                   |
| `--email <string>`        | Email address.                                                              |
| `-q, --quiet`             | Suppress the welcome banner and panel and print a one-line summary instead. |
| `--realm <string>`        | Realm to sign up on. Defaults to idyl.network.                              |
| `--subnet <string>`       | Default subnet for the new context.                                         |

## Inherited flags

| Flag                                 | Description                                                        |
| ------------------------------------ | ------------------------------------------------------------------ |
| `-a <string>, --account-id <string>` | Account ID to use, overriding the current context.                 |
| `-c <string>, --context <string>`    | Use the named context for this command.                            |
| `--homedir <string>`                 | Override the configuration directory. Defaults to \~/.config/idyl. |
| `-n <string>, --namespace <string>`  | Namespace to use for this command.                                 |
| `-o <string>, --output <string>`     | Output format (json\|yaml).                                        |
| `-p <string>, --profile <string>`    | Override the access profile for this command.                      |

## Examples

```bash theme={null}
# Interactive signup (prompts for email)
idyl signup

# Sign up with a specific email
idyl signup --email developer@example.com

# Sign up with a custom account name
idyl signup --email developer@example.com --account-name "My Project"

# Sign up on a specific realm
idyl signup --realm <realm> --email developer@example.com

# Non-interactive signup (accept terms via flag)
idyl signup --email developer@example.com --accept-terms
```