Skip to main content

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​

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​

NameRequiredDefaultDescription
--recursive, -rNo—Copy directories recursively
--access, -aNo—Access level for uploaded objects. Only applies to local-to-remote uploads. Options: public, private
--cache-controlNo—Cache-Control header stored with uploaded objects and returned on every read. Only applies to local-to-remote uploads

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/