Files
Jelle van der Waa 263f616496 containers: set opencontainers labels for cockpit-ws
Many popular containers set standardised annotations as a label to allow
container UI's to display additional container image details. Set a
subset of annotations which are useful for administrators running a
cockpit-ws container.

https://specs.opencontainers.org/image-spec/annotations/
2026-02-18 18:17:56 +01:00
..

Cockpit Containers

  • ws: Cockpit's web server, for installation on CoreOS; uses SSH to connect to the local host or remote machines
  • bastion: A reduced variant of the web server that runs unprivileged, and can only connect to remote machines. Suitable for deploying on e.g. Kubernetes. This is currently a prototype.
  • unit-tests: Our project's unit tests run in this container; usually on GitHub PRs, but you can also run it locally for reproducing failures.
  • flatpak: Scripts for locally building, running, and testing our Cockpit Client flatpak.

See the individual README.md files in the subdirectories for details.

ws container development

Build the container:

make ws-container

You can install locally built RPMs by copying them into the ws/rpms/ directory.

For fast iteration, you can also build the container with the binaries (cockpit-ws, cockpit-tls, etc.) and the pages (dist/*) from the local build tree. For that to work, you have to build the project on the same OS as the container, and configure with --prefix=/usr. No warranties, you have to know what you are doing!

make ws-container-build-tree

Run the built container and log in interactively as a shell:

make ws-container-shell

When running docker the 'sudo' command will be used to get necessary privileges.