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

<ResponseField name="--mkdir" type="boolean" default="false">
  Create missing parent directories for the remote path.
</ResponseField>

<ResponseField name="--show-all" type="boolean" default="false">
  Include Devboxes created by other users when selecting a target.
</ResponseField>

## Related topics

<Columns cols={2}>
  <Card title="Download a file" icon="download" href="/docs/reference/devbox-cli/download">
    Copy a file from a Devbox to the local machine.
  </Card>

  <Card title="Connect with SSH" icon="terminal" href="/docs/reference/devbox-cli/ssh">
    Open an interactive SSH connection to a Devbox.
  </Card>
</Columns>