Installation

Alternatively, rhysd/actionlint repository also provides its own Homebrew cask, which is automatically updated on new releases. If you prefer it, tap the repository and install actionlint package with --cask option.

brew tap "rhysd/actionlint" "https://github.com/rhysd/actionlint"
brew install --cask actionlint

Warning

Since the actionlint executable is unsigned, macOS displays a warning and tries to move it to the Trash. To allow it to run, go to 'Settings -> Privacy & Security' and grant the permission.

Prebuilt binaries

Download an archive file from the releases page for your platform, unarchive it and put the executable file to a directory in $PATH.

Prebuilt binaries are built at each releases by CI for the following OS and arch:

macOS (x86_64, arm64)
Linux (i386, x86_64, arm32, arm64)
Windows (i386, x86_64, arm64)
FreeBSD (i386, x86_64)

Note that the following targets are not tested since GitHub Actions doesn't support them:

Linux i386, arm32
Windows i386
FreeBSD i386, x86_64

To install these binaries gh command is useful. The following command is an example for x86_64 Linux.

gh release download --repo rhysd/actionlint --pattern '*_linux_amd64.tar.gz' v1.7.11
tar xf actionlint_1.7.11_linux_amd64.tar.gz
./actionlint -version

Optionally you can verify the attestation of the downloaded artifact. This is highly recommended in terms of security. Note that the attestation support was introduced since actionlint v1.7.11.

gh attestation verify -R rhysd/actionlint actionlint_1.7.11_linux_amd64.tar.gz

Download script

To install actionlint executable with one command, the download script is available. It downloads the latest version of actionlint (actionlint.exe on Windows and actionlint on other OSes) to the current directory automatically. This is a recommended way if you install actionlint in some shell script.

bash <(curl https://raw.githubusercontent.com/rhysd/actionlint/main/scripts/download-actionlint.bash)

When you need to install specific version of actionlint, please give the version to the 1st command line argument. The following example installs v1.6.17.

bash <(curl https://raw.githubusercontent.com/rhysd/actionlint/main/scripts/download-actionlint.bash) 1.6.17

This script downloads actionlint (or actionlint.exe on Windows) binary to the current working directory. When you need to put the downloaded binary to some other directory, please give the directory path to the 2nd command line argument. The following example installs the latest version to /usr/bin.

bash <(curl https://raw.githubusercontent.com/rhysd/actionlint/main/scripts/download-actionlint.bash) latest /usr/bin

For the usage of actionlint on GitHub Actions, see the usage document.

Docker image

See the usage document to know how to install and use an official actionlint Docker image.

Cross-platform version managers

asdf

You can install actionlint with the asdf version manager using the asdf-actionlint plugin, which automates the process of installing (and switching between) various versions of GitHub release binaries. With asdf already installed, run these commands to install actionlint:

# Add actionlint plugin
asdf plugin add actionlint

# Show all installable versions
asdf list-all actionlint

# Install specific version
asdf install actionlint latest

# Set a version globally (on your ~/.tool-versions file)
asdf global actionlint latest

mise

You can install actionlint with the mise-en-place which automates the process of installing (and switching between) various versions of GitHub release binaries. With mise already installed, run these commands to install actionlint:

# Show all installable versions
mise ls-remote actionlint

# Install specific version
mise install actionlint@latest

# Set a version globally (on your ~/.config/mise/config.toml file)
mise use -g actionlint@latest

Build from source

Recent Go toolchain is necessary to build actionlint from source. Last two major versions of Go are supported.

# Install the latest stable version
go install github.com/rhysd/actionlint/cmd/actionlint@latest

# Install the head of the main branch
go install github.com/rhysd/actionlint/cmd/actionlint@main

Checks | Usage | Configuration | Go API | References