---
name: "act"
section: "1"
platform: "linux"
package: "act"
version: "0.2.89-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/act"
---

# act(1)

Run GitHub actions locally by specifying the event name (e.g. push) or an action name directly.

## NAME

act - Run GitHub actions locally by specifying the event name (e.g. **push**) or an action name directly.

## SYNOPSIS

\*\*act \[event name to run\] \[flags\]

If no event name passed, will default to "on: push" If actions handles only one event it will be used as default instead of "on: push"\*\*

## DESCRIPTION

Run GitHub actions locally by specifying the event name (e.g. **push**) or an action name directly.

## OPTIONS

**--action-cache-path**="/build/.cache/act"\
 	Defines the path where the actions get cached and host workspaces created.

**--action-offline-mode**\[=false\]\
 	If action contents exists, it will not be fetch and pull again. If turn on this, will turn off force pull

**-a**, **--actor**="nektos/act"\
 	user that triggered the event

**--artifact-server-addr**="162.55.28.166"\
 	Defines the address to which the artifact server binds.

**--artifact-server-path**=""\
 	Defines the path where the artifact server stores uploads and retrieves downloads from. If not specified the artifact server will not start.

**--artifact-server-port**="34567"\
 	Defines the port where the artifact server listens.

**-b**, **--bind**\[=false\]\
 	bind working directory to container, rather than copy

**--bug-report**\[=false\]\
 	Display system information for bug report

**--cache-server-addr**="162.55.28.166"\
 	Defines the address to which the cache server binds.

**--cache-server-external-url**=""\
 	Defines the external URL for if the cache server is behind a proxy. e.g.: https://act-cache-server.example.com. Be careful that there is no trailing slash.

**--cache-server-path**="/build/.cache/actcache"\
 	Defines the path where the cache server stores caches.

**--cache-server-port**=0\
 	Defines the port where the artifact server listens. 0 means a randomly available port.

**--concurrent-jobs**=0\
 	Maximum number of concurrent jobs to run. Default is the number of CPUs available.

**--container-architecture**=""\
 	Architecture which should be used to run containers, e.g.: linux/amd64. If not specified, will use host default architecture. Requires Docker server API Version 1.41+. Ignored on earlier Docker server platforms.

**--container-cap-add**=\[\]\
 	kernel capabilities to add to the workflow containers (e.g. --container-cap-add SYS\_PTRACE)

**--container-cap-drop**=\[\]\
 	kernel capabilities to remove from the workflow containers (e.g. --container-cap-drop SYS\_PTRACE)

**--container-daemon-socket**=""\
 	URI to Docker Engine socket (e.g.: unix://~/.docker/run/docker.sock or - to disable bind mounting the socket)

**--container-options**=""\
 	Custom docker container options for the job container without an options property in the job definition

**--defaultbranch**=""\
 	the name of the main branch

**--detect-event**\[=false\]\
 	Use first event type from workflow as event that triggered the workflow

**-C**, **--directory**="."\
 	working directory

**-n**, **--dryrun**\[=false\]\
 	disable container creation, validates only workflow correctness

**--env**=\[\]\
 	env to make available to actions with optional value (e.g. --env myenv=foo or --env myenv)

**--env-file**=".env"\
 	environment file to read and use as env in the containers

**-e**, **--eventpath**=""\
 	path to event JSON file

**--github-instance**="github.com"\
 	GitHub instance to use. Only use this when using GitHub Enterprise Server.

**-g**, **--graph**\[=false\]\
 	draw workflows

**-h**, **--help**\[=false\]\
 	help for act

**--input**=\[\]\
 	action input to make available to actions (e.g. --input myinput=foo)

**--input-file**=".input"\
 	input file to read and use as action input

**--insecure-secrets**\[=false\]\
 	NOT RECOMMENDED! Doesn't hide secrets while printing logs.

**-j**, **--job**=""\
 	run a specific job ID

**--json**\[=false\]\
 	Output logs in json format

**-l**, **--list**\[=false\]\
 	list workflows

**--list-options**\[=false\]\
 	Print a json structure of compatible options

**--local-repository**=\[\]\
 	Replaces the specified repository and ref with a local folder (e.g. https://github.com/test/test@v0=/home/act/test or test/test@v0=/home/act/test, the latter matches any hosts or protocols)

**--log-prefix-job-id**\[=false\]\
 	Output the job id within non-json logs instead of the entire name

**--man-page**\[=false\]\
 	Print a generated manual page to stdout

**--matrix**=\[\]\
 	specify which matrix configuration to include (e.g. --matrix java:13

**--network**="host"\
 	Sets a docker network name. Defaults to host.

**--no-cache-server**\[=false\]\
 	Disable cache server

**--no-recurse**\[=false\]\
 	Flag to disable running workflows from subdirectories of specified path in '--workflows'/'-W' flag

**--no-skip-checkout**\[=false\]\
 	Use actions/checkout instead of copying local files into container

**-P**, **--platform**=\[\]\
 	custom image to use per platform (e.g. -P ubuntu-18.04=nektos/act-environments-ubuntu:18.04)

**--privileged**\[=false\]\
 	use privileged mode

**-p**, **--pull**\[=true\]\
 	pull docker image(s) even if already present

**-q**, **--quiet**\[=false\]\
 	disable logging of output from steps

**--rebuild**\[=true\]\
 	rebuild local action docker image(s) even if already present

**--remote-name**="origin"\
 	git remote name that will be used to retrieve url of git repo

**--replace-ghe-action-token-with-github-com**=""\
 	If you are using replace-ghe-action-with-github-com  and you want to use private actions on GitHub, you have to set personal access token

**--replace-ghe-action-with-github-com**=\[\]\
 	If you are using GitHub Enterprise Server and allow specified actions from GitHub (github.com), you can set actions on this. (e.g. --replace-ghe-action-with-github-com =github/super-linter)

**-r**, **--reuse**\[=false\]\
 	don't remove container(s) on successfully completed workflow(s) to maintain state between runs

**--rm**\[=false\]\
 	automatically remove container(s)/volume(s) after a workflow(s) failure

**-s**, **--secret**=\[\]\
 	secret to make available to actions with optional value (e.g. -s mysecret=foo or -s mysecret)

**--secret-file**=".secrets"\
 	file with list of secrets to read from (e.g. --secret-file .secrets)

**--strict**\[=false\]\
 	use strict workflow schema

**--use-gitignore**\[=true\]\
 	Controls whether paths specified in .gitignore should be copied into container

**--use-new-action-cache**\[=false\]\
 	Enable using the new Action Cache for storing Actions locally

**--userns**=""\
 	user namespace to use

**--validate**\[=false\]\
 	validate workflows

**--var**=\[\]\
 	variable to make available to actions with optional value (e.g. --var myvar=foo or --var myvar)

**--var-file**=".vars"\
 	file with list of vars to read from (e.g. --var-file .vars)

**-v**, **--verbose**\[=false\]\
 	verbose output

**--version**\[=false\]\
 	version for act

**-w**, **--watch**\[=false\]\
 	watch the contents of the local repo and run when files change

**-W**, **--workflows**="./.github/workflows/"\
 	path to workflow file(s)

## HISTORY

1-Jun-2026 Auto generated by spf13/cobra