For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationCommand referenceRelease notes
DocumentationCommand referenceRelease notes
  • Command reference
    • iagctl cert-gen
    • iagctl completion
      • create decorator
      • create executable-object
      • create registry
      • create repository
      • create secret
      • create user
    • iagctl login
    • iagctl runner
    • iagctl server
    • iagctl version
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • Prerequisites
  • Syntax
  • Usage notes
  • Temporary passwords
  • Examples
  • Create a user
  • Create a user with a temporary password
  • Options
  • Options inherited from parent commands
Command referenceiagctl create

iagctl create user

Was this page helpful?
Previous

iagctl db export

Next
Built with

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.

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

$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

$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

$iagctl create user user1 --temp-password

Options

$ -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

$ --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