# tigris cp

Copy files between local filesystem and Tigris, or between paths within Tigris. At least one side must be a remote `t3://` path.

**Alias:** `copy`

## Usage[​](#usage "Direct link to Usage")

```
tigris cp <src> <dest> [flags]

t3 copy <src> <dest> [flags]
```

Use the `t3://` (or `tigris://`) prefix for remote Tigris paths. Bare paths are treated as local files. At least one side must be remote.

## Flags[​](#flags "Direct link to Flags")

| Name                | Required | Default | Description                                                                                                             |
| ------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
| `--recursive`, `-r` | No       | —       | Copy directories recursively                                                                                            |
| `--access`, `-a`    | No       | —       | Access level for uploaded objects. Only applies to local-to-remote uploads. Options: `public`, `private`                |
| `--cache-control`   | No       | —       | `Cache-Control` header stored with uploaded objects and returned on every read. Only applies to local-to-remote uploads |

## Examples[​](#examples "Direct link to Examples")

```
# Upload a local file to remote

tigris cp ./file.txt t3://my-bucket/file.txt



# Upload a local file and make it public

tigris cp ./logo.png t3://my-bucket/logo.png --access public



# Download a remote object to local

tigris cp t3://my-bucket/file.txt ./local-copy.txt



# Copy a remote folder recursively

tigris cp t3://my-bucket/src/ t3://my-bucket/dest/ -r



# Upload a local folder to remote

tigris cp ./images/ t3://my-bucket/images/ -r



# Upload immutable assets with a long cache lifetime

tigris cp ./dist/ t3://my-bucket/assets/ -r --cache-control 'public, max-age=31536000, immutable'



# Copy with wildcard

tigris cp "t3://my-bucket/my-path/*.json" t3://my-bucket/new-path/
```
