---
name: "euare-usercreate"
section: "1"
platform: "linux"
package: "euca2ools"
version: "3.3.1-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/euare-usercreate"
---

# euare-usercreate(1)

Create a new user

## NAME

euare-usercreate - Create a new user

## SYNOPSIS

euare-usercreate \[-p PATH\] \[-g GROUP\_NAME\] \[--verify\] \[-k\] \[-v \| **-w\]**

- \[-d DOMAIN\] \[-l\] \[--as-account ACCOUNT\] \[-U URL\]

  \[--region USER@REGION\] \[-I KEY\_ID\] \[-S KEY\] \[--security-token TOKEN\] \[--debug\] \[--debugger\] \[--version\] \[-h\] USER

## DESCRIPTION

Create a new user

### positional arguments:

- USER

  name of the new user (required)

### optional arguments:

- **-p** PATH, **--path** PATH

  path for the new user (default: "/")

- **-g** GROUP\_NAME, **--group-name** GROUP\_NAME

  also add the new user to a group

- **--verify**

  ensure the group given with **-g** exists before doing anything

- **-k**, **--create-accesskey**

  also create an access key for the new user and show it

- **-v**, **--verbose**

  show the new user's ARN and GUID

- **-w**, **--write-config**

  output access keys and region information in the form of a [euca2ools.ini(5)](/euca2ools.ini/5.md) configuration file instead of by themselves (implies **-k**)

- **-d** DOMAIN, **--domain** DOMAIN

  the DNS domain to use for region information in configuration file output (default: based on IAM URL)

- **-l**, **--set-default-user**

  set this user as the default user for the region in [euca2ools.ini(5)](/euca2ools.ini/5.md) configuration file output. This option is only useful when used with **-w**.

- **--as-account** ACCOUNT

  \[Eucalyptus cloud admin only\] run this command as the administrator of another account

- **-U** URL, **--url** URL

  identity service endpoint URL

- **--region** USER@REGION

  region and/or user names to search when looking up config file data

**-I** KEY\_ID, **--access-key-id** KEY\_ID

**-S** KEY, **--secret-key** KEY

**--security-token** TOKEN

- **--debug**

  show debugging output

- **--debugger**

  launch interactive debugger on error

- **--version**

  show the program's version and exit

- **-h**, **--help**

  show this help message and exit