zhinst/labone repository overview

⁠LabOne Docker images

This GitHub repo⁠ hosts the Dockerfile generating Linux Docker images of LabOne. The supported architectures are Linux/amd64 and Linux/arm64.

⁠Dockerfile usage

You can build the image you need with the following command:

docker buildx build . --platform <platform> \
                      --target <target> \
                      --build_args LABONE_VERSION=<version> \
                      --tag <tag>

• --platform should be Linux/amd64 or Linux/arm64.

• --target should be one of labone_dataserver, labone_webserver, or labone_full. If omitted, it defaults to labone_full.

• LABONE_VERSION should be one of the officially released LabOne versions, starting with 23.02.42414.

• --tag is the Docker tag⁠

⁠Images

Pre-built images can be found at Docker Hub under the zhinst/labone⁠ repository.

⁠LabOne Data Server

This image contains only the LabOne Data Server and the device firmware packages. The ENTRYPOINT⁠ of this image is the LabOne Data Server.

Available Docker tags : <LABONE_VERSION>-dataserver, <LABONE_SHORT_VERSION>-dataserver

To run the Data Server, you can use the following command:

docker run -d --rm --name labone-dataserver \
           --network=host \
           zhinst/labone:23.06-dataserver

We recommend using --network=host to avoid port mapping issues. The Data Server relies on multicast to discover devices in the same network. By default, Docker containers are started in a bridged docker network, which renders devices invisible to the Data Server. Please get in touch⁠ if you need assistance with use cases that requires different network configuration.

⁠LabOne Web Server

This image contains all of the above plus the LabOne documentation and the LabOne Web Server, which serves as the image's ENTRYPOINT⁠.

Available Docker tags : <LABONE_VERSION>-webserver, <LABONE_SHORT_VERSION>-webserver

To run the Web Server, you can use the following command:

docker run -d --rm --name labone-webserver \
           --network=host \
           zhinst/labone:23.06-webserver

Also here, we recommend using --network=host to avoid port mapping issues. The Web Server relies on multicast to find Data Servers in the network.

⁠LabOne All-in-One image

This images contains the full installation of LabOne, plus Python and zhinst-core⁠. The ENTRYPOINT⁠ is a shell script⁠ starting both LabOne Web Server (in background) and Data Server.

Available Docker tags: <LABONE_VERSION>-full, <LABONE_SHORT_VERSION>-full

To run the LabOne All-in-One image, you can use the following command:

docker run -d --rm --name labone-full \
           --network=host \
           zhinst/labone:23.06-full