Skip to main content

gns3util project new

Create a Project

Synopsis

Create a new project on the controller.
gns3util project new [flags]

Examples

gns3util -s https://controller:3080 project new -n some_name

Options

      --auto-close              Close project when last client leaves (default true)
      --auto-open               Open project when GNS3 starts
      --auto-start              Start project when opened
      --close-after-creation    Close the project after creation (default true)
      --drawing-grid-size int   Grid size for drawings
      --grid-size int           Grid size for nodes
  -h, --help                    help for new
  -n, --name string             Desired name for the project
  -p, --path string             Filesystem path for the project
      --project-id string       Desired id for the project, leave empty for a generated one
      --scene-height int        Height of the drawing area
      --scene-width int         Width of the drawing area
      --show-grid               Show the grid on the drawing area
      --show-interface-labels   Show interface labels on the drawing area
      --show-layers             Show layers on the drawing area
      --snap-to-grid            Snap to grid on the drawing area
      --supplier-logo string    Path to the project supplier logo
      --supplier-url string     URL to the project supplier site
  -j, --use-json string         Provide a raw JSON string to send instead of flags
      --zoom int                Zoom of the drawing area

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: [kv, json, json-colorless, collapsed, yaml, toml]. Can be set via GNS3_OUTPUT (default "kv")
  -s, --server string     GNS3v3 Server URL. Can be set via GNS3_SERVER or config.toml

SEE ALSO

Auto generated by spf13/cobra on 18-Mar-2026