Podman Container Manager
=========================

Podman is a tool to manage pods and containers. Pods come from Kubernetes, that
define a pod this way:

    A Pod (as in a pod of whales or pea pod) is a group of one or more
    containers, with shared storage and network resources, and a specification
    for how to run the containers.

.. important::

    CoreOS doesn't mandate the use of `podman` for running container.

    But as we can't support every existing container runtime, `podman` is the
    only documented/supported way to run container.

    Other container runtimes are available inside the open source
    `meta-virtualization` layer that is available inside CoreOS.

Podman can be installed on an image by adding `podman` to the 
:ref:`IMAGE_FEATURES <ref-features-image>` variable.

By default, this will just provide the `podman` command. The `podman` command
is similar to the `docker` one, and most command should work by replacing 
`docker` by `podman`. See https://docs.podman.io/en/latest/Commands.html for
more info.

podman-tui
----------

The `podman-tui` package provide a terminal user interface for `podman`. This
package is automatically installed if both `podman` and `dev-tools`
:ref:`IMAGE_FEATURES <ref-features-image>` are enabled.

.. only:: html
    
    .. image:: podman/podman-tui.gif

.. only:: latex
    
    .. image:: podman/podman-tui.png

The above image was copied from https://github.com/containers/podman-tui/blob/e29e47fd392647033dc1c0cc0eaefa1f62661b98/docs/podman-tui.gif

cockpit-podman
--------------

The `cockpit-podman` package provide a :ref:`cockpit <ref-cockpit>` plugin that
allow to manage `podman` from the :ref:`cockpit <ref-cockpit>` web interface.

This package is automatically installed if both `podman` and `cockpit`
:ref:`IMAGE_FEATURES <ref-features-image>` are enabled.


.. only:: html

    .. image:: podman/cockpit-podman.gif

.. only:: latex

    .. image:: podman/cockpit-podman.png