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 node create

Create a node in a project

Synopsis

Create a node in a project. To use custom adapters the —use-json option has to be used.
gns3util node create [project-name/id] [flags]

Examples

gns3util -s https://controller:3080 node create my-project --name my-node --node-type qemu

Options

      --aux int                        Aux console port
      --aux-type string                Aux console type
      --compute-id string              Compute ID (default 'local')
      --console-auto-start             Automatically start console
      --console-port int               Console TCP port
      --console-type string            Console type (e.g., telnet)
      --first-port-name string         First port name
  -h, --help                           help for create
  -r, --label-rotation int             Label rotation
  -a, --label-style-attribute string   SVG style attribute for label
      --label-text string              Label text
  -x, --label-x-position int           Label X position
  -y, --label-y-position int           Label Y position
      --locked                         Lock node
  -n, --name string                    Node name
      --node-type string               Node type
  -f, --port-name-format string        Port name format (e.g., Ethernet{0})
  -m, --port-segment-size int          Port segment size
      --properties string              Custom properties JSON
      --symbol string                  Symbol name
  -j, --use-json string                Provide a raw JSON string to send instead of flags
      --x int                          X coordinate
      --y int                          Y coordinate
      --z int                          Z layer (default 1)

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