mirror of https://github.com/containers/podman.git
59 lines
2.3 KiB
Markdown
59 lines
2.3 KiB
Markdown
% podman-attach(1)
|
|
|
|
## NAME
|
|
podman\-attach - Attach to a running container
|
|
|
|
## SYNOPSIS
|
|
**podman attach** [*options*] *container*
|
|
|
|
**podman container attach** [*options*] *container*
|
|
|
|
## DESCRIPTION
|
|
**podman attach** attaches to a running *container* using the *container's name* or *ID*, to either view its ongoing output or to control it interactively.\
|
|
The *container* can be detached from (and leave it running) using a configurable key sequence. The default sequence is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-keys** OPTION, or specifying it in the `containers.conf` file: see **[containers.conf(5)](https://github.com/containers/common/blob/master/docs/containers.conf.5.md)** for more information.
|
|
|
|
## OPTIONS
|
|
#### **--detach-keys**=**sequence**
|
|
|
|
Specify the key **sequence** for detaching a *container*. Format is a single character `[a-Z]` or one or more `ctrl-<value>` characters where `<value>` is one of: `a-z`, `@`, `^`, `[`, `,` or `_`. Specifying "" will disable this feature.\
|
|
The default is `ctrl-p,ctrl-q`.
|
|
|
|
#### **--latest**, **-l**
|
|
|
|
Instead of providing the *container ID* or *name*, use the last created *container*. If other methods than Podman are used to run *containers* such as `CRI-O`, the last started *container* could be from either of those methods.\
|
|
The default is **false**.\
|
|
*IMPORTANT: This OPTION is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines. This OPTION does not need a container name or ID as input argument.*
|
|
|
|
#### **--no-stdin**
|
|
|
|
Do not attach STDIN. The default is **false**.
|
|
|
|
#### **--sig-proxy**
|
|
|
|
Proxy received signals to the process (non-TTY mode only). SIGCHLD, SIGSTOP, and SIGKILL are not proxied.\
|
|
The default is **true**.
|
|
|
|
## EXAMPLES
|
|
Attach to a container called "foobar".
|
|
```
|
|
$ podman attach foobar
|
|
```
|
|
|
|
Attach to the latest created container.
|
|
```
|
|
$ podman attach --latest
|
|
```
|
|
|
|
Attach to a container that start with the ID "1234".
|
|
```
|
|
$ podman attach 1234
|
|
```
|
|
|
|
Attach to a container without attaching STDIN.
|
|
```
|
|
$ podman attach --no-stdin foobar
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/master/docs/containers.conf.5.md)**
|