Hadolint
github.com
- Free plan
- Windows
- macOS
- Linux
- Web
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.
Plans
Every plan and priceHadolint
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.