> ## Content Index
> Fetch the complete content index at: https://www.oransblog.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Act: Run test github actions locally!
- URL: https://www.oransblog.com/act/
- Published: 2021-11-13T06:34:37.000Z
- Updated: 2026-10-29T05:56:59.000Z
- Description: I was looking for a faster way to debug github actions, and i found it!
- Author: Oran C
- Tags: linux, docker, #Import 2026-11-12 01:14

I was looking for a faster way to debug github actions, and i found it!

![](https://www.oransblog.com/content/images/2021/11/image-17.png)

# *Enter 'Act'*

[nektos/act: Run your GitHub Actions locally 🚀](https://github.com/nektos/act?ref=oransblog.com)

it uses docker underneath to run action locally

# Required

install this :

[Docker Desktop for Mac and Windows | DockerLearn why Docker Desktop is the preferred choice for millions of developers building containerized applications. Download for Mac or Windows.![](https://www.docker.com/sites/default/files/d8/Docker-R-Logo-08-2018-Monochomatic-RGB_Moby-x1.png)Docker![](https://www.docker.com/sites/default/files/social/docker_facebook_share.png)](https://www.docker.com/products/docker-desktop?ref=oransblog.com)

# Windows install

Required install chocolatey

[Chocolatey Software | Installing Chocolatey](https://chocolatey.org/install?ref=oransblog.com)

```bash
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
```

### [Chocolatey](https://chocolatey.org/?ref=oransblog.com) (Windows)

```bash
choco install act-cli
```

# Linux install 

### Bash script

Run this command in your terminal:

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

# How to use it?

### cd to github repo with .github/workflows/ folder  
run the following

```bash

act -l
> ID               Stage  Name
> chrome-headless  0      chrome-headless

act chrome-headless -l

------------
RUN this command bellow
act
```

![](https://www.oransblog.com/content/images/2021/11/image-18.png)

![](https://www.oransblog.com/content/images/2021/11/image-19.png)

it asks if you want to install large, medium or small docker image, i picked small because i use node.js

![](https://www.oransblog.com/content/images/2021/11/image-20.png)

resutls of \`act\`

# 🎊🎊Success! we just ran github actions locally!🎊🎊

---

# **Author**

```
by oran collins
github.com/wisehackermonkey
oranbusiness (❁´◡`❁) gmail ^_____^ com
20211112
```