Tools: Latest: You Can Run GitHub Actions Locally With act — No More Commit-Push-Wait Cycles

Tools: Latest: You Can Run GitHub Actions Locally With act — No More Commit-Push-Wait Cycles

Stop Pushing to Test Your Workflows

Install

Run Workflows

How It Works

Pass Secrets

Use Cases

Limitations act runs GitHub Actions locally using Docker. Test your CI/CD pipeline in seconds instead of pushing and waiting. act reads your .github/workflows/ YAML files and runs them in Docker containers. Same environment as GitHub, but on your machine. But for 90% of workflows, it just works. Templates let you quickly answer FAQs or store snippets for re-use. Hide child comments as well For further actions, you may consider blocking this person and/or reporting abuse

Command

Copy

# macOS -weight: 500;">brew -weight: 500;">install act # Linux -weight: 500;">curl -s https://raw.githubusercontent.com/nektos/act/master/-weight: 500;">install.sh | -weight: 600;">sudo bash # macOS -weight: 500;">brew -weight: 500;">install act # Linux -weight: 500;">curl -s https://raw.githubusercontent.com/nektos/act/master/-weight: 500;">install.sh | -weight: 600;">sudo bash # macOS -weight: 500;">brew -weight: 500;">install act # Linux -weight: 500;">curl -s https://raw.githubusercontent.com/nektos/act/master/-weight: 500;">install.sh | -weight: 600;">sudo bash # Run default workflow act # Run specific event act push act pull_request # Run specific job act -j test act -j build # List all workflows act -l # Run default workflow act # Run specific event act push act pull_request # Run specific job act -j test act -j build # List all workflows act -l # Run default workflow act # Run specific event act push act pull_request # Run specific job act -j test act -j build # List all workflows act -l # From file act --secret-file .secrets # Inline act -s MY_TOKEN=abc123 # From environment act -s MY_TOKEN # From file act --secret-file .secrets # Inline act -s MY_TOKEN=abc123 # From environment act -s MY_TOKEN # From file act --secret-file .secrets # Inline act -s MY_TOKEN=abc123 # From environment act -s MY_TOKEN - Debug failing CI — no more commit-push-wait-check cycles - Test new workflows before pushing - Run workflows offline - Speed up development — local runs are faster than cloud - Test matrix builds locally - Some GitHub-hosted runners have tools not in Docker images - Services (like postgres) need extra Docker setup - GitHub-specific features (OIDC, caching) may not work