podman-run

Create and start containers from images

TLDR

Run a container

$ podman run [image]

Run interactively

$ podman run -it [image] [/bin/bash]

Run in background

$ podman run -d [image]

Run with port mapping

$ podman run -p [8080:80] [image]

Run with volume mount

$ podman run -v [/host/path:/container/path] [image]

Run with name

$ podman run --name [mycontainer] [image]

SYNOPSIS

podman run [options] image [command]

podman run creates and starts a new container from a specified image. It is the primary command for launching containers, supporting interactive sessions (-it), background execution (-d), port mapping (-p), volume mounts (-v), and environment variables (-e).
The --rm flag automatically removes the container when it exits. The --name option assigns a human-readable name. By default, Podman runs containers rootlessly without requiring a daemon, making it a drop-in replacement for docker run.

PARAMETERS

IMAGE

Container image.

-it

Interactive terminal.

-d, --detach

Run in background.

-p, --publish PORT

Port mapping.

-v, --volume MOUNT

Volume mount.

--name NAME

Container name.

-e, --env VAR

Environment variable.

--rm

Remove after exit.

CAVEATS

Rootless by default. Docker-compatible flags.

HISTORY

podman run provides container execution as a Docker-compatible command.