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 cluster-control create user

Bootstrap a user’s role assignments directly in etcd

​
Synopsis

Writes a UserPermissions record directly to etcd to bootstrap access for a user. Use —admin to grant full admin access. This assigns the built-in “admin” role, which is the only role that bypasses role-object lookups in the permission checker and is required for commands like add-cluster (which calls /auth/status). Use —roles for any other role names, but note those roles must already exist as Role objects in etcd (created separately) or the permission checks will silently fail at runtime. 
gns3util cluster-control create user [username] [flags]

​
Options

      --admin           Grant the built-in "admin" role (bypasses role-object lookup; required for add-cluster and other admin-gated commands)
      --config string   Path to cluster_access.toml (Env: GNS3_CONFIG)
      --etcd string     Etcd endpoint (default "localhost:2379")
  -h, --help            help for user
      --roles string    Comma-separated list of role names to assign (roles must exist in etcd)

​
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