Overview of Podman run command

Start a new container from an image by using the podman run command. This command pulls the image if necessary and launches the container process with its own isolated file system and network.

The podman run command runs a process in a new container-based on a container image. If the container image is not already loaded, podman run pulls the image and all its dependencies from the repository, as if running podman pull image, before starting the container from that image. The container process has its own file system, networking, and an isolated process tree.

The podman run command has the form:

podman run [options] image [command [arg ...]]

Basic options are:

  • --detach (-d): Runs the container in the background and prints the new container ID.
  • --attach (-a): Runs the container in the foreground mode.
  • --name (-n): Assigns a name to the container. If a name is not assigned to the container with --name then it generates a random string name. This works for both background and foreground containers.
  • --rm: Automatically remove the container when it exits. Note that the container will not be removed when it could not be created or started successfully.
  • --tty (-t): Allocates and attaches the pseudo-command line to the standard input of the container.
  • --interactive (-i): For interactive processes, use -i and -t together to allocate a command line for the container process. The -i -t is often written as -it.