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

> Download a file from a Devbox.

Download a remote file from a Devbox over SSH. If you omit the Devbox name, the CLI prompts you to select one.

## Usage

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

## Examples

### Save a remote log locally

```bash theme={null}
devbox download my-devbox /var/log/my-app.log ./logs/my-app.log --mkdir
```

### Write a remote file to standard output

```bash theme={null}
devbox download my-devbox /tmp/result.json -
```

Use `-` as `<local-path>` to stream the file to standard output. Otherwise, the command creates or truncates the local destination file. `devbox download` does not recursively download directories.

## Options

<ResponseField name="--mkdir" type="boolean" default="false">
  Create missing local parent directories with mode `0755`.
</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="Upload a file" icon="upload" href="/docs/reference/devbox-cli/upload">
    Copy a local file to a Devbox.
  </Card>

  <Card title="Execute a command" icon="terminal" href="/docs/reference/devbox-cli/exec">
    Run a command on a Devbox.
  </Card>
</Columns>