Skip to content
On this page

Getting Started

Installation

Labctl is distributed as a single executable for Linux based distros

bash
bash -c "$(curl -sL https://labctl.net/get.sh)"

Run a console command

labctl includes console commands, al list of these commands can be seen when you run the command without parameters, or using the --help flag with any of the sub-commands. The command reference includes details on each command

labctl --help
bash
Usage: labctl <command>

Control your network lab.

Flags:
  -h, --help    Show context-sensitive help.

Global Flags
  -d, --debug=INT          Enable debug mode.
      --settings=STRING    Settings yaml file.

Commands:
  color                  Add some color to any Linux command (i.e. ssh).
  config commit          Commit configuration on the node.
  config compare         Compare rendered templates to the node's config.
  config send            Send commands to the node (i.e. show)
  config template        Show rendered templates.
  config vars            Show variable inputs.
  serve                  Serve the web UI.
  install-completions    install shell completions
  version                show the labctl version

Run "labctl <command> --help" for more information on a command.

Start the web server

The Config Engine UI can be started with the labctl serve command.

Once the server is started you should be able to open the suggested URLs with your browser

$ labctl serve -t topo.clab.yaml -p ./ --addr :8080
INFO[0000] Parsing & checking topology file: topo.clab.yaml
INFO[0000] Access the web server on http://localhost:8080 or http://10.10.56.51:8080

The labctl serve reference contains detail on available flags for the web server.