Skip to content

Containerized Installation

Method 1: Installing from Docker Hub (fast)

Pull the latest Docker image from Docker Hub:

docker pull manuelrueda/clarid-tools:latest
docker image tag manuelrueda/clarid-tools:latest cnag/clarid-tools:latest

Method 2: Building from the repository Dockerfile

Download the Dockerfile from GitHub:

wget https://raw.githubusercontent.com/CNAG-Biomedical-Informatics/clarid-tools/main/docker/Dockerfile

Then build the container:

  • For Docker version 19.03 and above (supports buildx):
docker buildx build -t cnag/clarid-tools:latest .
  • For Docker versions older than 19.03 (no buildx support):
docker build -t cnag/clarid-tools:latest .

Running and Interacting with the Container

The Docker image already includes the external QR dependencies used by clarid-tools qrcode, including qrencode and zbarimg (zbar-tools).

To run the container:

docker run -tid -e USERNAME=root --name clarid-tools cnag/clarid-tools:latest

To connect to the container:

docker exec -ti clarid-tools bash

Or, to run directly from the host:

alias clarid-tools='docker exec -ti clarid-tools /usr/share/clarid-tools/bin/clarid-tools'
clarid-tools

System requirements

  • OS/ARCH supported: linux/amd64 and linux/arm64.
  • Ideally a Debian-based distribution (Ubuntu or Mint), but any other (e.g., CentOS, OpenSUSE) should do as well (untested).
  • 1GB of RAM
  • >= 1 core (ideally i7 or Xeon).
  • At least 5GB HDD.

Common errors: Symptoms and treatment

  • Dockerfile:
      * DNS errors

    - Error: Temporary failure resolving 'foo'

      Solution: https://askubuntu.com/questions/91543/apt-get-update-fails-to-fetch-files-temporary-failure-resolving-error