GT-ADMIN-USER-CREATE(1)        gitea-cli Manual        GT-ADMIN-USER-CREATE(1)



NAME
       gt-admin-user-create - Create an account



SYNOPSIS
       gt admin user create [<username>] [flags]



DESCRIPTION
       Create an account. On a terminal, gt asks for a missing username, email
       address and password; the new account must change its password on its
       first sign-in unless --must-change-password=false is passed.


   JSON FIELDS
       active, admin, created_at, description, email, full_name, id, location,
       prohibit_login, restricted, url, username, visibility, website



OPTIONS
       --admin[=false]     Administrator privileges (use =false to revoke)


       --email=""     Email address


       --full-name=""      Display name


       -h, --help[=false]  help for create


       --must-change-password[=true]      Require password change on next
       sign-in (use =false to disable)


       --password=""  Password (prefer --password-file)


       --password-file=""  Read password from file or - for stdin; remove one
       trailing line ending


       --prohibit-login[=false]      Prohibit signing in (use =false to
       revoke)


       --restricted[=false]     Restrict account access (use =false to revoke)


       --username=""  Account username


       --visibility=""     Profile visibility, by default the instance's
       default {public|limited|private}



OPTIONS INHERITED FROM PARENT COMMANDS
       --csv[=""]     Output CSV with the specified comma-separated fields, or
       all fields


       --debug[=false]     Log the method, URL, status, and duration of each
       HTTP request to stderr


       --host=""      Gitea instance URL, including any base path


       --interactive[=false]    Allow prompts with machine output


       -q, --jq=""    Filter JSON output using a jq expression; implies --json


       --json[=""]    Output JSON with the specified comma-separated fields,
       or all fields


       --no-input[=false]  Disable prompts and implicit editor/browser
       interactions


       --sudo=""      Perform API requests as this user (requires an
       administrator account)


       --user=""      Account name on the selected instance



EXAMPLE
       $ gt admin user create carol --email carol@example.com
       # read the password from a file instead of a prompt
       $ gt admin user create ci-bot --email ci@example.com --password-file pw.txt --must-change-password=false



SEE ALSO
       gt-admin-user(1)

gitea-cli                          Nov 2026            GT-ADMIN-USER-CREATE(1)