---
title: Copy
description: >-
  Studios:         
  lit://<owner>/<teamspace>/studios/<studio-name>/<path>

  Teamspace drives: lit://<owner>/<teamspace>/uploads/<path>

  Current teamspace (relativ
canonical: 'https://lightning.ai/docs/cli/stable/command-details/cp'
---
# Copy {#copy}

Copy between local, Studios, Drive.

Every lit:// URL must include a resource root at the start of its drive path that tells Lightning where to send the file. There is no default - a URL without a root will fail.

URL formats:

Studios: lit://<owner>/<teamspace>/studios/<studio-name>/<path> Teamspace drives: lit://<owner>/<teamspace>/uploads/<path> Current teamspace (relative): lit:///<resource-root>/<path>

**Usage:**

```console
lightning cp [OPTIONS] SOURCE [DESTINATION]
```

## Arguments {#cp-arguments}

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `SOURCE` | `text` | yes | Source path to copy. |
| `DESTINATION` | `text` | no | Optional destination path. |

## Options {#cp-options}

| Option | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--recursive`, `-r` | — | no | `Sentinel.UNSET` | Copy directories recursively |
| `--cloud-account` | `TEXT` | no | — | Cloud account to store uploads on. Where one is needed, defaults to the current cloud account (LIGHTNING\_CLUSTER\_ID) or the teamspace’s default cloud account. |

## Examples {#cp-examples}

```console
lightning cp source.txt lit://<owner>/<my-teamspace>/studios/<my-studio>/destination.txt
lightning cp -r source_folder/ lit://<owner>/<my-teamspace>/studios/<my-studio>/destination_folder/
lightning cp source.txt lit://<owner>/<my-teamspace>/uploads/destination.txt
lightning cp source.txt lit:///uploads/destination.txt
lightning cp -r source_folder/ lit:///studios/<my-studio>/destination_folder/
```

---

**Navigation**

- Parent: [Command details](/docs/cli/2026.11.04/command-details.md)