| gerrit create-account |
| ===================== |
| |
| NAME |
| ---- |
| gerrit create-account - Create a new user account. |
| |
| SYNOPSIS |
| -------- |
| [verse] |
| 'ssh' -p <port> <host> 'gerrit create-account' |
| [--group <GROUP>] |
| [--full-name <FULLNAME>] |
| [--email <EMAIL>] |
| [--ssh-key - | <KEY>] |
| [--http-password <PASSWORD>] |
| <USERNAME> |
| |
| DESCRIPTION |
| ----------- |
| Creates a new internal-only user account. |
| |
| If the account is created without an email address, it may only be |
| used for batch/role access, such as from an automated build system |
| or event monitoring over link:cmd-stream-events.html[gerrit stream-events]. |
| |
| Note, however, that in this case the account is not implicitly added |
| to the 'Non-Interactive Users' group. The account must be explicitly |
| added to the group with the `--group` option. |
| |
| If LDAP authentication is being used, the user account is created |
| without checking the LDAP directory. Consequently users can be |
| created in Gerrit that do not exist in the underlying LDAP directory. |
| |
| ACCESS |
| ------ |
| Caller must be a member of the privileged 'Administrators' group, |
| or have been granted |
| link:access-control.html#capability_createAccount[the 'Create Account' global capability]. |
| |
| SCRIPTING |
| --------- |
| This command is intended to be used in scripts. |
| |
| OPTIONS |
| ------- |
| <USERNAME>:: |
| Required; SSH username of the user account. |
| |
| --ssh-key:: |
| Content of the public SSH key to load into the account's |
| keyring. If `-` the key is read from stdin, rather than |
| from the command line. |
| |
| --group:: |
| Name of the group to put the user into. Multiple --group |
| options may be specified to add the user to multiple groups. |
| |
| --full-name:: |
| Display name of the user account. |
| + |
| Names containing spaces should be quoted in single quotes ('). |
| This most likely requires double quoting the value, for example |
| `--full-name "'A description string'"`. |
| |
| --email:: |
| Preferred email address for the user account. |
| |
| --http-password:: |
| HTTP password for the user account. |
| |
| EXAMPLES |
| -------- |
| Create a new batch/role access user account called `watcher` in |
| the 'Non-Interactive Users' group. |
| |
| ==== |
| $ cat ~/.ssh/id_watcher.pub | ssh -p 29418 review.example.com gerrit create-account --group "'Non-Interactive Users'" --ssh-key - watcher |
| ==== |
| |
| GERRIT |
| ------ |
| Part of link:index.html[Gerrit Code Review] |
