Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Hadolint

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
7.7 Club score Visit github.com

What Hadolint is

Hadolint is a free Dockerfile linter that checks files for errors and best practices. It parses Dockerfiles into an abstract syntax tree and applies rules to that structure. For Bash code inside Dockerfile RUN instructions, it uses ShellCheck. Hadolint rules use the DL prefix, while ShellCheck rules use SC.

You can ignore rules, override their severity, set failure thresholds, choose output formats, and configure label schemas and trusted registries. Reports can use formats including tty, JSON, Checkstyle, Code Climate, GitLab Code Climate, GNU, Codacy, SonarQube, SARIF, and JUnit. Hadolint can run as a pre-commit hook or in Docker and Podman containers. Prebuilt binaries are offered for macOS, Windows, and Linux; installation options also include Homebrew, Scoop, Nix, containers, and source builds. The project documents CI integrations such as GitHub Actions, GitLab CI, Azure DevOps Pipelines, Bitbucket Pipelines, CircleCI, Drone CI, Jenkins, and Travis CI, alongside editor integrations including VS Code, Atom, Emacs, Geany, Sublime Text, Vim, and NeoVim. It also links to an online version and is licensed under GPL-3.0.

Who it suits

Hadolint suits developers and teams who want Dockerfile checks in local workflows, editors, pre-commit hooks, or CI. Its configurable rules and report formats also support teams with specific review and reporting needs.

Good to know, and what to watch

  • Checks Bash in RUN instructions with ShellCheck.
  • Rule severity and failure thresholds are configurable.
  • Supports ten listed report formats.
  • Offers prebuilt binaries for Linux, macOS, and Windows.
  • Documents integrations for CI systems and editors.
  • The project is licensed under GPL-3.0.
  • No free trial is listed.

Hadolint

Free

Free plan

The verdict

Hadolint provides Dockerfile checks with configurable rules, multiple output formats, and documented editor and CI integrations. It is a free, GPL-3.0 licensed option for teams that want linting across development and build workflows.

What the maker publishes

Bash analysis
It uses ShellCheck to lint Bash code inside Dockerfile RUN instructions. source
CI integrations
The project documents integrations including GitHub Actions, GitLab CI, Azure DevOps Pipelines, Bitbucket Pipelines, CircleCI, Drone CI, Jenkins, and Travis CI. source
Configuration
Users can configure ignored rules, severity overrides, failure thresholds, output format, label schemas, and trusted registries. source
Container use
Hadolint can run from Docker or Podman container images published on Docker Hub and GitHub Container Registry. source
Downloads
Prebuilt binaries are offered for OSX, Windows, and Linux, with installation also described through Homebrew, Scoop, Nix, containers, or source builds. source
Editor integrations
Documented editor integrations include VS Code, Atom, Emacs, Geany, Sublime Text, Vim, and NeoVim. source
Latest release
The release page opened for this research lists v2.15.1 as the latest release. source
License
The repository identifies its license as GPL-3.0. source
Online version
The README links to an online version hosted at hadolint.github.io/hadolint. source
Output formats
Supported report formats include tty, json, checkstyle, codeclimate, gitlab_codeclimate, gnu, codacy, sonarqube, sarif, and junit. source
Parsing
The linter parses Dockerfiles into an abstract syntax tree and applies rules to it. source
Pre-commit
Hadolint is available as a pre-commit hook, including a Docker-based hook option. source
Purpose
Hadolint is a Dockerfile linter that checks Dockerfiles for errors and best practices. source
Rule sources
Its rules include Hadolint rules with the DL prefix and ShellCheck rules with the SC prefix. source

Checked against the maker's pages on 8 Oct 2026.