act(1) act(1) 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-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. --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 --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] Do not skip actions/checkout -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) --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 --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-Jan-2025 Auto generated by spf13/cobra act 0.2.71 Jan 2025 act(1)