# Reference > Cli > Run lambda

# `run-lambda` - run an Artillery test on AWS Lambda

```sh
artillery run-lambda [options] <script>
```

## Options

### Lambda-specific flags

| Option                                                      | Description                                                                                                                                                                                                                                                                                                |
| :---------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--region <region>`                                         | The AWS region to run in (`us-east-1`, `us-west-1`, `eu-west-1`, `eu-central-1`, `ap-south-1`, `ap-northeast-1`)                                                                                                                                                                                           |
| `--count <num>`                                             | Number of load generators to launch.                                                                                                                                                                                                                                                                       |
| `--tags <tags>`                                             | Comma-separated list of tags in key:value format to tag the test run, for example: `--tags team:sre,service:foo`.                                                                                                                                                                                          |
| `--note <text>`                                             | Attach a note to a text, for example: `--note "This is a spike test for service foo"`.                                                                                                                                                                                                                     |
| `--container`                                               | Use a container image for Lambda                                                                                                                                                                                                                                                                           |
| `--memory-size <number>`                                    | Memory size of the Lambda function in bytes. Default: `4096`.                                                                                                                                                                                                                                              |
| `--lambda-role-arn <role>`  | ARN of the IAM role to use for the Lambda function.                                                                                                                                                                                                                                                        |
| `--security-group-ids <ids>`                                | Comma-separated list of AWS VPC security group IDs to launch Lambda tasks in.                                                                                                                                                                                                                              |
| `--subnet-ids <ids>`                                        | Comma-separated list of subnet IDs to use for the Lambda function.                                                                                                                                                                                                                                         |
| `--architecture <string>`                                   | Architecture of the Lambda function. Default: `arm64` ([Graviton](https://aws.amazon.com/blogs/aws/aws-lambda-functions-powered-by-aws-graviton2-processor-run-your-functions-on-arm-and-get-up-to-34-better-price-performance/)). Legacy x86 may be set with `x86_64`  |

#### Making additional files available in workers

Please use the [includeFiles](../test-script#includefiles---explicitly-bundling-files-with-the-test) option to make any additional files available to workers.

### Shared flags

The `run-lambda` command shares many options with the `run` command:

| Option                                                 | Description                                                                                                                                                    |
| :----------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--output`, `-o`                                       | Write a JSON report to a file                                                                                                                                  |
| `--environment`, `-e`                                  | Run the test using the specified environment                                                                                                                   |
| `--config`, `-c`                                       | Load `config` section from another file                                                                                                                        |
| `--scenario-name`       | Run only the specified scenario (exact match or regex)                                                                                                         |
| `--overrides`                                          | Override values in the test script dynamically                                                                                                                 |
| `--target`, `-t`                                       | Set or override target URL for the test                                                                                                                        |
| `--variables`, `-v`                                    | Set scenario variables dynamically                                                                                                                             |
| `--env-file <path>` The `--dotenv` is deprecated since ()                                      | Set environment variables with a .env file                                                                                                                     |
| `--quiet`, `-q`  | Run in quiet mode                                                                                                                                              |
| `--insecure`, `-k`                                     | Turn off TLS verification. *Should not be used in production*                                                                                                  |
| `--name <value>`          | Set the name of the test run. This name will be shown in the Artillery Cloud dashboard and used to group multiple runs of the same test.                       |
| `--record` and `--key`  | Record test run to [Artillery Cloud](https://www.artillery.io/cloud). Learn more about [recording test runs](/docs/get-started/artillery-cloud). |