Run containerlab labs on a Linux host and drive them over HTTPS. One server, every lab, every user, one REST API: deploy, inspect, exec, capture, and share labs from scripts, CI, or the Containerlab Apps.
Documentation: srl-labs.github.io/clab-api-server · API reference
On a Linux host with Docker (amd64 or arm64):
curl -fsSL https://raw.githubusercontent.com/srl-labs/clab-api-server/main/install.sh | sudo bash -s -- install
sudo usermod -aG clab_api <username>
sudo systemctl enable --now clab-api-serverThe server listens on https://<host>:8090. Containerlab is built in; there is nothing else to install. For containers, plain binaries, and Kubernetes, see Install.
TOKEN=$(curl -sk -X POST https://localhost:8090/login \
-H 'Content-Type: application/json' \
-d '{"username":"<username>","password":"<password>"}' | jq -r .token)
curl -sk -H "Authorization: Bearer $TOKEN" https://localhost:8090/api/v1/labsNext: the quick start deploys a lab end to end. A running server also serves Swagger UI at /swagger/index.html and ReDoc at /redoc.
task # tidy, generate the OpenAPI spec, build into dist/
task test # integration tests against a running server
task docs # preview the documentation siteSee Develop and test.