Solutions provisioner

A control panel that runs the industry solutions rather than being one of them. It starts and stops each solution, connects to a Litmus Edge once instead of once per solution, and provisions or removes each one from its own card.

Use it when you want to show more than one solution, or to switch between them without editing compose files. Every solution also runs perfectly well on its own, so this is a convenience rather than a requirement.

Everything in Industry solutions, plus one thing specific to the panel: it needs access to the host Docker socket, because it starts each solution as a sibling container so their ports land on the host.

That is a real grant of authority to a container. It is how a control panel of this kind has to work, and it is worth knowing before you run it.

The solution ships two ways. Use the registry if the host can reach Google Artifact Registry, and the downloaded archive if it cannot.

Requires a read-only registry credential, supplied by Litmus separately.

Save this as docker-compose.yml:

Then open http://localhost:4009.

Nothing needs filling in to start it. The panel asks for the Litmus Edge address and a token, verifies them, and stores them itself. The two EDGE_ values above only let you skip that step.

Download solgen-provisioner-0.3.0-amd64.tar.gz from the solution's page on portal.litmus.io. The archive is the container image, not a source bundle, and needs no registry access.

docker load prints the image it added:

That reference is the one the compose file above already names, so the same docker-compose.yml and .env now work offline with no docker login:

To run it without Compose, the three mounts and flags below are not optional. The panel starts each solution as a sibling container on the host's own daemon, so it needs the socket; it keeps the Edge connection and the logs in /data, so it needs the volume; and it reaches each solution on the host's published ports, so it needs a route to the host.

EDGE_URL and EDGE_API_TOKEN are optional: pass them to skip the connect step, or leave them out and connect from the page, which stores them in /data/.env. SIM_HOST does not apply to the panel; each solution derives its own.

SOLGEN_REGISTRY and SOLGEN_IMAGE_TAG are optional and only needed to point at a different registry or tag. Leave them out rather than setting them empty: an empty SOLGEN_REGISTRY means "use local image names" and makes every card resolve to an image no host can pull.

SOLGEN_REGISTRY and SOLGEN_IMAGE_TAG are written without a value on purpose. Compose leaves a variable absent when it has no value, which lets the default apply. Giving them an empty string instead would mean something different and the panel would look for images that do not exist.

The page is three parts.

Litmus Edge, at the top: what you are connected to, whether it is answering, and how recently that was checked.

Solutions, a card each: a switch to start and stop it, what it puts on the Edge, the scenarios it demonstrates, a link to its operator view, and Deploy and Clean up controls with previews.

Team solutions, below: the published Litmus solutions catalogue joined against the container registries this machine can read, so what is published and what you could actually run here are one view rather than two. Solutions this machine has no credential for are greyed out rather than shown as errors.

A solution that is more than one container cannot be started as a single container, and the panel says so on the card rather than offering a button that cannot work. Rotating equipment reliability is the one this affects: it needs a message broker alongside it, so it is deployed with its own compose file.

Solutions the panel started keep running, deliberately, so restarting the panel does not interrupt a demonstration. Stop them from their cards first if you want them to go too.

[email protected]