Install act on Ubuntu 20.04

The act is a command line tool that allows to run GitHub Actions in local environment. It reads .github/workflows and determines the set of actions that need to be run. The act is based on Docker.

This tutorial shows how to install act on Ubuntu 20.04.

Prepare environment

You must have Git and Docker installed in the system:

No.SoftwareInstallation instructions

Install act

Run the following command to download tar.gz. file from releases page of the act repository:

wget -qO act.tar.gz

Extract act executable file to /usr/local/bin directory:

sudo tar xf act.tar.gz -C /usr/local/bin act

Now act command can be used all users as system-wide command.

We can check act version as follows:

act --version

Remove tar.gz file:

rm -rf act.tar.gz

Testing act

Clone the sample repository for testing:

git clone

Run the act command and specify working directory with -C option to run GitHub Actions locally:

act -C github-actions-demo

For the first time, you will be asked to choose image to be used as default. You can select Medium size image. It can be changed later in ~/.actrc configuration file.

The act run jobs defined in YAML file which stored in github/workflows directory:

[CI/test] Start
[CI/test] *  Run actions/checkout@v2
[CI/test]   Success - actions/checkout@v2
[CI/test] *  Run actions/setup-node@v1
[CI/test]   Success - actions/setup-node@v1
[CI/test] *  Run npm install
[CI/test]   Success - npm install
[CI/test] *  Run npm test
|   GET /
|     ✓ should respond with hello world
|   1 passing (28ms)
[CI/test]   Success - npm test

Uninstall act

If act is no longer needed, remove the executable file:

sudo rm -rf /usr/local/bin/act

You can also remove configuration file and cache:

rm -rf ~/.actrc
rm -rf ~/.cache/act

Leave a Comment

Your email address will not be published.