github.com/containers/libpod@v1.9.4-0.20220419124438-4284fd425507/docs/source/markdown/podman-container-checkpoint.1.md (about)

     1  % podman-container-checkpoint(1)
     2  
     3  ## NAME
     4  podman\-container\-checkpoint - Checkpoints one or more running containers
     5  
     6  ## SYNOPSIS
     7  **podman container checkpoint** [*options*] *container* ...
     8  
     9  ## DESCRIPTION
    10  Checkpoints all the processes in one or more containers. You may use container IDs or names as input.
    11  
    12  ## OPTIONS
    13  **--keep**, **-k**
    14  
    15  Keep all temporary log and statistics files created by CRIU during checkpointing. These files
    16  are not deleted if checkpointing fails for further debugging. If checkpointing succeeds these
    17  files are theoretically not needed, but if these files are needed Podman can keep the files
    18  for further analysis.
    19  
    20  **--all**, **-a**
    21  
    22  Checkpoint all running containers.
    23  
    24  **--latest**, **-l**
    25  
    26  Instead of providing the container name or ID, checkpoint the last created container.
    27  
    28  The latest option is not supported on the remote client.
    29  
    30  **--leave-running**, **-R**
    31  
    32  Leave the container running after checkpointing instead of stopping it.
    33  
    34  **--tcp-established**
    35  
    36  Checkpoint a container with established TCP connections. If the checkpoint
    37  image contains established TCP connections, this options is required during
    38  restore. Defaults to not checkpointing containers with established TCP
    39  connections.
    40  
    41  **--export**, **-e**
    42  
    43  Export the checkpoint to a tar.gz file. The exported checkpoint can be used
    44  to import the container on another system and thus enabling container live
    45  migration. This checkpoint archive also includes all changes to the container's
    46  root file-system, if not explicitly disabled using **--ignore-rootfs**
    47  
    48  **--ignore-rootfs**
    49  
    50  This only works in combination with **--export, -e**. If a checkpoint is
    51  exported to a tar.gz file it is possible with the help of **--ignore-rootfs**
    52  to explicitly disable including changes to the root file-system into
    53  the checkpoint archive file.
    54  
    55  ## EXAMPLE
    56  
    57  podman container checkpoint mywebserver
    58  
    59  podman container checkpoint 860a4b23
    60  
    61  ## SEE ALSO
    62  podman(1), podman-container-restore(1)
    63  
    64  ## HISTORY
    65  September 2018, Originally compiled by Adrian Reber <areber@redhat.com>