Skip to content

Rules Reference

tally supports rules from multiple sources, each with its own namespace prefix.

Rule Namespaces

Namespace Source Description
tally/ tally Custom rules implemented by tally
buildkit/ BuildKit Linter Docker's official Dockerfile checks
hadolint/ Hadolint Hadolint-compatible Dockerfile rules
shellcheck/ ShellCheck ShellCheck-derived rules implemented natively in tally
  • tally Rules - Custom rules for security, maintainability, and style
  • BuildKit Rules - Docker's official checks, reimplemented with auto-fix support
  • Hadolint Rules - Hadolint-compatible rules, with auto-fix and enhanced detection
  • ShellCheck Rules - ShellCheck-derived rules implemented and documented by tally

Configuration

Configure rules in .tally.toml:

[rules]
# Enable/disable rules by pattern
include = ["buildkit/*"]                     # Enable all buildkit rules
exclude = ["buildkit/MaintainerDeprecated"]  # Disable specific rules

# Configure rule options
[rules.tally.max-lines]
severity = "warning"
max = 100
skip-blank-lines = true
skip-comments = true

Inline Directives

Suppress rules using inline comments:

# tally ignore=buildkit/StageNameCasing
FROM alpine AS Build

# hadolint ignore=DL3024
FROM alpine AS builder

See Configuration Guide for more details.