# 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 |

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

```
# Upload a local file to remote

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



# 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



# Copy with wildcard

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