Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gns3util.saygex.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
gns3util user new

Create a user account

​
Synopsis

Create a new user account on the GNS3v3 controller. Either provide -u and -p (and optional fields) or pass a full JSON payload using —use-json. 
gns3util user new [flags]

​
Examples

gns3util -s https://controller:3080 create user -u alice -p secret --email [email protected]

​
Options

  -e, --email string       Email address for the user
  -f, --full-name string   Full name for the user
  -h, --help               help for new
  -a, --is-active          Mark the user as active
  -p, --password string    Password for the user
  -j, --use-json string    Provide a raw JSON string to send instead of flags
  -u, --username string    Desired username for the user

​
Options inherited from parent commands

  -c, --cluster string      Cluster name from keyfile. Mutually exclusive with --server
  -i, --insecure            Ignore unsigned SSL-Certificates. Can be set via GNS3_INSECURE
  -k, --key-file string     Path to authentication keyfile. Can be set via GNS3_KEY_FILE or config.toml
  -o, --output string       Output format: [json, json-colorless, collapsed, yaml, toml, table, table-ascii]. Can be set via GNS3_OUTPUT (default "table")
  -s, --server string       GNS3v3 Server URL. Can be set via GNS3_SERVER or config.toml
      --user string[="~"]   User to select from the keyfile. Omit the value to open a fuzzy picker (--user), or pass a name (--user alice).

​
SEE ALSO

Auto generated by spf13/cobra on 9-May-2026