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
# 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