---
name: "ch-ssh"
section: "1"
platform: "linux"
package: "charliecloud-runtime"
version: "0.31-1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/ch-ssh"
---

# ch-ssh(1)

Run a remote command in a Charliecloud container

## NAME

ch-ssh - Run a remote command in a Charliecloud container

## SYNOPSIS

```
$ CH_RUN_ARGS="NEWROOT [ARG...]"
$ ch-ssh [OPTION...] HOST CMD [ARG...]
```

## DESCRIPTION

Runs command **CMD** in a Charliecloud container on remote host **HOST**. Use the content of environment variable **CH\_RUN\_ARGS** as the arguments to **ch-run** on the remote host.

**NOTE:**

Words in **CH\_RUN\_ARGS** are delimited by spaces only; it is not shell syntax.

## EXAMPLE

On host **bar.example.com**, run the command **echo hello** inside a Charliecloud container using the unpacked image at **/data/foo** with starting directory **/baz**:

```
$ hostname
foo
$ export CH_RUN_ARGS='--cd /baz /data/foo'
$ ch-ssh bar.example.com -- hostname
bar
```

## REPORTING BUGS

If Charliecloud was obtained from your Linux distribution, use your distribution’s bug reporting procedures.

Otherwise, report bugs to: *https://github.com/hpc/charliecloud/issues*

## SEE ALSO

[charliecloud(7)](/charliecloud/7.md)

Full documentation at: \<*https://hpc.github.io/charliecloud*\>

## COPYRIGHT

2014–2022, Triad National Security, LLC and others