---
image: /generated/articles-docs-lambda-cli-still.png
id: still
sidebar_label: still
title: 'npx remotion lambda still'
slug: /lambda/cli/still
crumb: 'Lambda CLI Reference'
---

Using the `npx remotion lambda still` command, you can render a still frame in the cloud.

The command has the following structure:

```
npx remotion lambda still <serve-url>? [<composition-id>] [<output-location>]
```

- Obtain a [Serve URL](/docs/terminology/serve-url) using the [`sites create`](/docs/lambda/cli/sites/create) command or by calling [`bundle()`](/docs/bundle) and [`deploySiteFromBundle()`](/docs/lambda/deploysitefrombundle).
- The [Composition ID](/docs/terminology/composition#composition-id). If not specified, the list of compositions will be fetched and you can choose a composition.
- The `output-location` parameter is optional. If you don't specify it, the still is stored in your S3 bucket. If you specify a location, it gets downloaded to your device in an additional step.

## Example commands

Rendering a still:

```
npx remotion lambda still https://remotionlambda-abcdef.s3.eu-central-1.amazonaws.com/sites/testbed/index.html my-comp
```

Rendering using the serve URL shorthand:

```
npx remotion lambda still testbed my-comp
```

:::info
If you are using the shorthand serve URL, you have to pass a composition ID. Available compositions can only be fetched if a complete serve URL is passed.
:::

Rendering the 10th frame of a composition:

```
npx remotion lambda still --frame=10 testbed my-comp
```

Downloading the result to a `out.png` file:

```
npx remotion lambda still testbed my-comp out.png
```

## Flags

### `--frame`

<Options id="frame" />

### `--region`

The [AWS region](/docs/lambda/region-selection) to select. Both project and function should be in this region.

### `--props`

<Options id="props" />

:::note
Inline JSON string isn't supported on Windows shells because it removes the `"` character, use a file name instead.
:::

### `--scale`

[Scales the output frames by the factor you pass in.](/docs/scaling) For example, a 1280x720px frame will become a 1920x1080px frame with a scale factor of `1.5`. Vector elements like fonts and HTML markups will be rendered with extra details.

### `--log`

Log level to be used inside the Lambda function. Also, if you set it to `verbose`, a link to CloudWatch will be printed where you can inspect logs.

### `--privacy`

Defines if the output media is accessible for everyone or not. Either `public` or `private`, default `public`.

### `--max-retries`

How many times a single chunk is being retried if it fails to render. Default `1`.

### `--out-name`

The file name of the media output as stored in the S3 bucket. By default, it is `out` plus the appropriate file extension, for example: `out.png`. Must match `/([0-9a-zA-Z-!_.*'()/]+)/g`.

### `--s3-output-provider-endpoint`

The endpoint for an [`s3OutputProvider`](/docs/lambda/custom-destination#saving-to-another-cloud). Use it to save the rendered still to an S3-compatible provider such as Cloudflare R2.

When using this option, also pass `--force-bucket-name` and `--out-name`. If your provider requires credentials, set `REMOTION_S3_OUTPUT_PROVIDER_ACCESS_KEY_ID` and `REMOTION_S3_OUTPUT_PROVIDER_SECRET_ACCESS_KEY`.

```bash
REMOTION_S3_OUTPUT_PROVIDER_ACCESS_KEY_ID=<access-key-id> \
REMOTION_S3_OUTPUT_PROVIDER_SECRET_ACCESS_KEY=<secret-access-key> \
npx remotion lambda still testbed my-comp \
  --force-bucket-name=my-r2-bucket \
  --out-name=renders/still.png \
  --privacy=no-acl \
  --s3-output-provider-endpoint=https://<account-id>.r2.cloudflarestorage.com \
  --s3-output-provider-region=auto
```

### `REMOTION_S3_OUTPUT_PROVIDER_ACCESS_KEY_ID`

The access key ID to use with `--s3-output-provider-endpoint`.

### `REMOTION_S3_OUTPUT_PROVIDER_SECRET_ACCESS_KEY`

The secret access key to use with `--s3-output-provider-endpoint`.

### `--s3-output-provider-region`

The region to use with `--s3-output-provider-endpoint`.

### `--s3-output-provider-force-path-style`

Passes `forcePathStyle` to the S3 client created for `--s3-output-provider-endpoint`.

### `--image-format`

<Options id="still-image-format" />

`pdf` is not supported on Remotion Lambda due to function size constraints.

### `--jpeg-quality`

[Value between 0 and 100 for JPEG rendering quality](/docs/config#setjpegquality). Doesn't work when rendering an image format other than JPEG.

### ~~`--quality`~~

Renamed to `jpegQuality` in `v4.0.0`.

### `--ignore-certificate-errors`

Results in invalid SSL certificates in Chrome, such as self-signed ones, being ignored.

### `--disable-web-security`

This will most notably disable CORS in Chrome among other security features.

### `--dark-mode`<AvailableFrom v="4.0.381"/>

<Options id="dark-mode" />

### `--user-agent`<AvailableFrom v="3.3.83"/>

Lets you set a custom user agent that the headless Chrome browser assumes.

### `--media-cache-size-in-bytes`<AvailableFrom v="4.0.352"/>

<Options id="media-cache-size-in-bytes" />

### `--offthreadvideo-cache-size-in-bytes`<AvailableFrom v="4.0.23"/>

<Options id="offthreadvideo-cache-size-in-bytes" />

### `--offthreadvideo-video-threads`<AvailableFrom v="4.0.261"/>

<Options id="offthreadvideo-video-threads" />

### `--delete-after`<AvailableFrom v="4.0.32"/>

<Options id="delete-after" cli />

### `--force-path-style`<AvailableFrom v="4.0.202" />

Passes `forcePathStyle` to the AWS S3 client. If you don't know what this is, you probably don't need it.

### `--storage-class`<AvailableFrom v="4.0.305"/>

An [identifier](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html#sc-compare) for the S3 storage class of the rendered media. Default: `undefined` (which is `STANDARD`).

### `--license-key`<AvailableFrom v="4.0.409"/>

<Options id="license-key" />

### ~~`--api-key`<AvailableFrom v="4.0.253"/>~~

_deprecated in v4.0.409_

<Options id="api-key" />