Skip to content

Installation#

Controller#

Clabernetes controller (a.k.a. manager) is installed via Helm; this means if you don't have Helm - install it, it's easy.

With Helm installed, to install the latest released Clabernetes to an existing k8s cluster1 do:

helm upgrade --install --create-namespace --namespace clabernetes \
    clabernetes oci://ghcr.io/srl-labs/clabernetes/clabernetes

To upgrade to the latest version re-run the installation command and the latest version will be installed on the cluster.

To install a specific clabernetes version add --version flag like so:

helm upgrade --version 0.0.5 --install \
    clabernetes oci://ghcr.io/srl-labs/clabernetes/clabernetes

To uninstall clabernetes from the cluster:

helm uninstall clabernetes

Clabverter#

What a name, huh? Clabverter is a helper CLI tool that tries to make your life easier when you want to make your existing containerlab topology to work in a k8s setting.

Clabverter is versioned the same way as Clabernetes, and the recommended way to use it is by leveraging the container image2 we offer:

set up clabverter alias
docker pull ghcr.io/srl-labs/clabernetes/clabverter
alias clabverter="mkdir -p converted && chown -R 65532:65532 converted && \
    docker run -v $(pwd):/clabernetes/work --rm \
    ghcr.io/srl-labs/clabernetes/clabverter"

In case you need to install a specific version:

alias clabverter="docker run -v $(pwd):/clabverter --rm \
    ghcr.io/srl-labs/clabernetes/clabverter:<version>"

In case you need to install a specific version:

alias clabverter="docker run -v $(pwd):/clabverter --rm \
    ghcr.io/srl-labs/clabernetes/clabverter:dev-latest"

  1. Want to quickly spin up a local k8s cluster with clabernetes? Check out our Quickstart

  2. You already have Docker installed if you use containerlab, right?