Skip to main content
Usage: fal runners [-h] [--debug] [--pdb] [--cprofile] command ...

Manage fal runners.

Options:
  -h, --help  show this help message and exit
Commands:
  command
    stop        Stop a runner gracefully.
    kill        Kill a runner.
    list        List runners.
    logs (log)  Show logs for a runner.

​
List

Usage: fal runners list [-h] [--debug] [--pdb] [--cprofile] [--team TEAM]

List runners.

Options:
  -h, --help   show this help message and exit
  --team TEAM  The team to use.

​
Logs

Usage: fal runners logs [-h] [--output {pretty,json}] [--json] [--team TEAM]
                        [--search SEARCH] [--since SINCE] [--until UNTIL]
                        [--follow] [--lines LINES]
                        id

Show logs for a runner.

Positional Arguments:
  id                    Runner ID.

Options:
  -h, --help            show this help message and exit
  --team TEAM           The team to use.
  --search SEARCH       Search for string in logs.
  --since SINCE         Show logs since the given time. Accepts 'now', relative like '30m', '1h', or an ISO timestamp. Defaults to runner start time or to '1m ago' in --follow mode.
  --until UNTIL         Show logs until the given time. Accepts 'now', relative like '30m', '1h', or an ISO timestamp. Defaults to runner finish time or 'now' if it is still running.
  --follow, -f          Follow logs live. If --since is not specified, implies '--since 1m ago'.
  --lines, -n LINES     Only show latest N log lines. If '+' prefix is used, show oldest N log lines. Ignored if --follow is used.

Output:
  --output {pretty,json}
                        Modify the command output
  --json                Output in JSON format (same as --output json)

​
Stop

Usage: fal runners stop [-h] [--debug] [--pdb] [--cprofile] [--team TEAM] id

Stop a runner gracefully.

Positional Arguments:
  id           Runner ID.

Options:
  -h, --help   show this help message and exit
  --team TEAM  The team to use.

​
Kill

Usage: fal runners kill [-h] [--debug] [--pdb] [--cprofile] id

Kill a runner.

Positional Arguments:
  id          Runner ID.

Options:
  -h, --help  show this help message and exit

Debug:
  --debug     Show verbose errors.
  --pdb       Start pdb on error.
  --cprofile  Show cProfile report.