---
name: "piuparts_slave_join"
section: "8"
platform: "linux"
package: "piuparts-slave"
version: "1.6.0"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/piuparts_slave_join"
---

# piuparts\_slave\_join(8)

joins a running piuparts-slave session in screen

## NAME

piuparts\_slave\_join - joins a running piuparts-slave session in screen

## SYNOPSIS

*piuparts\_slave\_join*

## DESCRIPTION

*piuparts\_slave\_join* joins a running piuparts-slave session in screen.

## OPTIONS

There are no options to this command.

## ENVIRONMENT

Running piuparts in master-slave mode requires configuration in */etc/piuparts*.

## NOTES

Make sure to also read */usr/share/doc/piuparts-master/README\_server.txt*.

See *screen* (1) for full instructions on how to navigate between displays. In short:

```
*Ctrl-A <n>*::
   Navigates to display <n>. Slaves are found at screens 1 through 'slave-count', defined in the piuparts configuration file.
*Ctrl-A d*::
   Detach from *screen*. The session can be re-established with *piuparts-slave-join*.
```

## SEE ALSO

*piuparts* (1), *piuparts\_slave\_run* (8), *screen* (1)

## AUTHOR

Holger Levsen (*holger@layer-acht.org*)