# manage-runners cache update

> Update a cache; connection or sharing changes recreate the VMs of active runners that use it

Source: https://managerunners.com/docs/cli/reference/cache-update/

| | |
| --- | --- |
| Required scopes | `runners:read`, `runners:write` |
| Required flags | none |
| Changes state | yes |
| Destructive | no |
| Paid resource effect | `recreate` |
| Confirmation | `paid_resource` |
| Non-interactive use | supported |

> This command may delete and recreate an active runner's VM. Read [confirmations](https://managerunners.com/docs/cli/agents/#confirmations) before running it non-interactively.

## Usage

```text
Update a cache; connection or sharing changes recreate the VMs of active runners that use it

Usage:
  manage-runners cache update [flags]

Flags:
      --access-key-id string    S3 access key ID
      --bucket string           bucket name
      --id string               cache id
      --insecure                use plain HTTP instead of HTTPS
      --name string             cache name; resolving it needs runners:read
      --new-name string         rename the cache
      --path-prefix string      optional object path prefix inside the bucket
      --path-style string       addressing style: auto|path|virtual (default auto for create)
      --profile string          configuration profile
      --region string           bucket region, for example fsn1 or eu-central-1
      --secret-key-env string   environment variable containing the S3 secret key
      --secret-key-stdin        read the S3 secret key from stdin
      --server-address string   S3 server host[:port] without scheme, for example fsn1.your-objectstorage.com
      --shared string           share the cache between runners: on|off (default on for create)
      --yes                     confirm recreating the VMs of active runners that use the cache; required when the connection or sharing changes
```

Every command also accepts the [global flags](https://managerunners.com/docs/cli/reference/#global-flags). For machine-readable help, run `manage-runners help cache update --output json`.