act
Command-line tool that runs GitHub Actions workflows locally in Docker containers.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 1 known high or critical vulnerability in the packages a fresh install brings (OSV.dev, 16 Nov 2026). Weigh this before you install it.
go:github.com/klauspost/compress v1.18.7Panic on two-block frames in github.com/klauspost/compress (GO-2026-6865, high, fixed in 1.20.2)
Linux x86_64
You need first
- Runtimes:
go (to build from source) - System packages:
docker
Download the act_Linux_x86_64 release tarball and install the act binary into ~/.local/bin
mkdir -p ~/.local/bin /tmp/act && curl -fsSL -o /tmp/act/act.tar.gz https://github.com/nektos/act/releases/latest/download/act_Linux_x86_64.tar.gz && tar -xzf /tmp/act/act.tar.gz -C /tmp/act && install -m755 /tmp/act/act ~/.local/bin/act
Where the README and reality differ
- README: (not mentioned)
What worked: On the first run without -P or ~/.config/act/actrc, act asks you to choose a default image and waits for input (it hung in non-interactive mode). Pass -P to skip the prompt
Check that it works
act --versionThe output should contain “act version”.
First thing to try
mkdir -p /tmp/demo/.github/workflows && cd /tmp/demo && git init -q && cat > .github/workflows/ci.yml <<'EOF'
name: CI
on: push
jobs:
build:
runs-on: ubuntu-latest
steps:
- run: echo "hello from act $GITHUB_WORKSPACE"
test:
runs-on: ubuntu-latest
needs: build
steps:
- run: echo testing
EOFcd /tmp/demo && act push -P ubuntu-latest=-self-hostedGo to a Git repository that has workflow files in .github/workflows and run act push -P ubuntu-latest=-self-hosted.
What it does
- Run GitHub Actions workflows on your own machineTested
How to use it
- Go to a Git repository with a workflow file in
.github/workflows. - Run
act push -P ubuntu-latest=-self-hostedto run the workflows triggered by a push. - Check the output for a "Job succeeded" line for each job.
- Go to a Git repository with a workflow file in
- Use workflow jobs in place of a MakefileTested
How to use it
- Define the tasks you want as jobs in a workflow file in
.github/workflows. - Run a single job with
act -j <job> -P ubuntu-latest=-self-hosted.
- Define the tasks you want as jobs in a workflow file in
- Use the same environment variables and files as GitHubNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 2 of 3 features work
- Needs the network
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- test changes to GitHub workflow files without pushing
- use GitHub Actions workflows as a local task runner instead of a Makefile
An alternative to make.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Needed the network
- Checked on 15 Nov 2026
- Version 0.2.97
Differences the test machine hit
- README: Install Go, git clone git@github.com:nektos/act.git, make install
In the test: Prebuilt release binary from https://github.com/nektos/act/releases/latest/download/act_Linux_x86_64.tar.gz (no Go needed). The SSH clone URL also needs a GitHub SSH key; HTTPS would be needed for anonymous cloning - README: act uses the Docker API to run containers for each action
In the test: No Docker in this box: container runs fail with 'failed to connect to the docker API'. Running with -P ubuntu-latest=-self-hosted runs the jobs on the host instead