ACT Setup

Run GitHub Actions workflows locally using ACT.

Installation

macOS

brew install act

Linux

curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash

Usage

List Available Workflows

act --list

Run Specific Workflows

# Run CI pipeline
act -W .github/workflows/ci.yml
 
# Run specific jobs
act -W .github/workflows/ci.yml -j lint-and-format
act -W .github/workflows/ci.yml -j test
act -W .github/workflows/ci.yml -j build

Troubleshooting

bun Not Found

Use full Ubuntu image with bun pre-installed.

Network Issues

act --network host

Verbose Debugging

act --verbose
act --debug

Environment Variables Architecture Overview

On This Page

Installation macOS Linux Usage List Available Workflows Run Specific Workflows Troubleshooting bun Not Found Network Issues Verbose Debugging

View as Markdown