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

# iagctl create user

Create a new user.

The `iagctl create user` command creates a user on a gateway server when you run it from a gateway client. All users created in the gateway are superusers with full access to the system. Only create users you fully trust.

For more information, see [Manage users and credentials](../manage-users-credentials).

## Prerequisites

If no users exist yet, you need to log in with the `admin` user before running this command. For more information, see the "Admin user creation" section in the `iagctl server -h` help output.

## Syntax

```bash
iagctl create user <username> [flags]
```

## Usage notes

### Temporary passwords

Use the `--temp-password` flag to require the new user to change their password at the next login. This lets you set up new users without sharing permanent passwords.

## Examples

### Create a user

```bash
iagctl create user kevin
Enter your password:
Re-enter your password for verification:
Password verified successfully!

Successfully created user
Name:   kevin
```

### Create a user with a temporary password

```bash
iagctl create user user1 --temp-password
```

## Options

```bash
  -h, --help        Help for user
  --temp-password   Set a temporary password. The user must change this password at the next login.
```

## 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
```