# runai workspace attach

attach to a running container in a workspace job

```
runai workspace attach [WORKLOAD_NAME] [flags]
```

## Examples

```
# Attaching to the main worker of a workspace
runai workspace attach workspace-01 --tty --stdin

# Attaching to a specific pod of a workspace
runai workspace attach workspace-01 --pod workspace-01-worker-1 --tty --stdin
```

## Options

```
  -c, --container string               Container name for log extraction
  -h, --help                           help for attach
      --pod string                     Workload pod ID for log extraction, default: master (0-0)
      --pod-running-timeout duration   Pod check for running state timeout.
  -p, --project string                 Specify the project to which the command applies. By default, commands apply to the default project. To change the default project use ‘runai config project <project name>’
  -i, --stdin                          Pass stdin to the container
  -t, --tty                            Stdin is a TTY
      --wait-timeout duration          Timeout for waiting for workload to be ready for log streaming
```

## Options inherited from parent commands

```
      --config-file string   config file name; can be set by environment variable RUNAI_CLI_CONFIG_FILE (default "config.json")
      --config-path string   config path; can be set by environment variable RUNAI_CLI_CONFIG_PATH
  -d, --debug                enable debug mode
  -q, --quiet                enable quiet mode, suppress all output except error messages
      --verbose              enable verbose mode
```

## SEE ALSO

* [runai workspace](https://run-ai-docs.nvidia.com/self-hosted/2.20/reference/cli/runai/runai_workspace) - workspace management