Published on October 30, 2015
Author Waqar Ali Zaidi
Notice: This post is more than a year old. Some of the content might be outdated.

LinkChecker - Dockerized

The reason for dockerizing LinkChecker is to facilitate Praqma’s Gijeli set-up and produce reports for web projects. There are other Docker images of LinkChecker out there, but we find them lacking when it comes to entertaining stable automated builds.

Any change applied to the image will trigger a new Jenkins job and the build process will tag each release with a version number.


GiJeli is a word made up as a contraction of Git, Jekyll and Liquid

Jekyll is a Ruby gem that renders Markdown and Liquid to static HTML pages.

  • Jekyll is the stand-alone engine that drives GitHub pages.
  • By running Jekyll you can effectively have an equivalent to GitHub pages anywhere.


Pulling LinkChecker Docker Image

All versions will be available at Praqma’s Docker Hub.

  docker pull praqma/linkchecker:v[version number]


linux / iOS:

    docker run -v $(pwd):/data praqma/linkchecker:v[version number] [Options] [Output Options] [URL]


    docker run -v /$(pwd):\\data praqma/linkchecker:v[version number] [Options] [Output Options] [URL]


Using the LinkChecker Docker image we want to produce a report for in CSV format named and place it in /your-project/your-report-folder/. To achieve this, the following steps will be taken:

  1. cd to your-project directory
  2. Create your-report-folder with write privileges. mkdir -p -m 777 your-report-folder
  3. Run the LinkChecker Docker image with the following command:
docker run -v $(pwd):/data praqma/linkchecker:v1 --check-css --check-html --complete --anchors -F=csv/your-report-folder/

Have a cup of coffee or tea while you wait for your report to be generated. We are using Jenkins jobs to automate report production for our jekyll web projects. Don’t forget to read our extra article for a deeper dive into generating and publishing LinkChecker reports.

For a detailed overview of LinkChecker options see the documentation

Related Stories

Related Stories


Developing Embedded Software with DevOps

A guide on how to improve development processes

How to visualize project health in Jira

Tips to improve project management in the Atlassian suite

Testing Kubernetes Deployments within CI Pipelines

Low overhead, on-demand Kubernetes clusters deployed on CI Workers Nodes with KIND