---
title: "ezgh fleets run"
description: "Run a command or a saved script on nodes."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh fleets run

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh fleets run (--node n... | --tag key=value...) (--command c | --script s) [--as account] [--wait] [flags]
```

Run a command (with /bin/sh -c) or a saved script's version on nodes: those named with `--node` (ID, slug or name; repeat), or every node in the project with all the `--tag` key=value pairs when the run starts. It runs as `--as` on each node (default ezgh-user); IAM decides which accounts you may use.

`--max-concurrency` (a number or a percentage of the targets, default 50) limits how many nodes run it at once, and `--max-errors` (default 0) how many may fail before no more start. `--timeout` (default 1h) ends each invocation; an offline node has `--delivery-timeout` (default 1h) to come online. Output isn't kept: each node reports its status and exit code.

Without `--wait` it prints the run as created; `ezgh fleets runs get` follows it. With `--wait` it waits until the run ends, prints every node's result, and exits 1 unless every invocation succeeded.

Part of [`ezgh fleets`](/cli/reference/fleets).

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--as` | string | `ezgh-user` | the account to run as on each node |
| `--command` | string |  | the command, run with /bin/sh -c |
| `--delivery-timeout` | string |  | how long an offline node has to come online: 30s to 48h (default 1h) |
| `--max-concurrency` | string |  | nodes running it at once: a number or a percentage (default 50) |
| `--max-errors` | string |  | failures after which no more nodes start it: a number or a percentage (default 0) |
| `--node` | string, repeatable |  | a node to run on: ID, slug or name (repeat) |
| `--param` | string, repeatable |  | a script parameter, name=value (repeat) |
| `--script` | string |  | a saved script to run: ID, slug or name |
| `--tag` | string, repeatable |  | run on every node with this tag, key=value (repeat: all must match) |
| `--timeout` | string |  | how long each invocation may run: 1s to 48h (default 1h) |
| `--version` | int |  | the script's version (default: its latest) |
| `--wait` | boolean |  | wait until the run ends, print every node's result, and exit 1 unless all succeeded |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/fleets-run/index.mdx
