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-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
24-Mar-2026 Auto generated by spf13/cobra