> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# devbox upload

> Upload a file to a Devbox.

Upload a local file to a Devbox over SSH. The command preserves the file's permission bits. If you omit the Devbox name, the CLI prompts you to select one.

## Usage

```bash theme={null}
devbox upload [name] <local-path> <remote-path> [flags]
```

## Examples

### Upload a configuration file

```bash theme={null}
devbox upload my-devbox ./config.json /tmp/my-app/config.json --mkdir
```

The source must be a file that the CLI can open. `devbox upload` does not recursively upload directories and does not prompt before replacing the remote destination.

## Options

**--mkdir** `boolean` (default: false)

Create missing parent directories for the remote path.

**--show\_all** `boolean` (default: false)

Include Devboxes created by other users when selecting a target.

## Related topics

> [card] [Download a file](https://namespace.so/docs/reference/devbox-cli/download.md)
>
> Copy a file from a Devbox to the local machine.

> [card] [Connect with SSH](https://namespace.so/docs/reference/devbox-cli/ssh.md)
>
> Open an interactive SSH connection to a Devbox.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.