OS Manuals

/usr/bin/podman-remote

A tool for managing OCI containers and pods

From podman-5.8 5.8.9-r3 (enterprise-packages), captured 2026-11-08 by running podman-remote --help (exit 0). permalink

Manage pods, containers and images

Usage:
  podman-remote [options] [command]

Available Commands:
  artifact    Manage OCI artifacts
  attach      Attach to a running container
  build       Build an image using instructions from Containerfiles
  commit      Create new image based on the changed container
  compose     Run compose workloads via an external provider such as docker-compose or podman-compose
  container   Manage containers
  cp          Copy files/folders between a container and the local filesystem
  create      Create but do not start a container
  diff        Display the changes to the object's file system
  events      Show podman system events
  exec        Run a process in a running container
  export      Export container's filesystem contents as a tar archive
  farm        Farm out builds to remote machines
  generate    Generate structured data based on containers, pods or volumes
  healthcheck Manage health checks on containers
  help        Help about any command
  history     Show history of a specified image
  image       Manage images
  images      List images in local storage
  import      Import a tarball to create a filesystem image
  info        Display podman system information
  init        Initialize one or more containers
  inspect     Display the configuration of object denoted by ID
  kill        Kill one or more running containers with a specific signal
  kube        Play containers, pods or volumes from a structured file
  load        Load image(s) from a tar archive
  login       Log in to a container registry
  logout      Log out of a container registry
  logs        Fetch the logs of one or more containers
  machine     Manage a virtual machine
  manifest    Manipulate manifest lists and image indexes
  network     Manage networks
  pause       Pause all the processes in one or more containers
  pod         Manage pods
  port        List port mappings or a specific mapping for the container
  ps          List containers
  pull        Pull an image from a registry
  push        Push an image to a specified destination
  quadlet     Allows users to manage Quadlets
  rename      Rename an existing container
  restart     Restart one or more containers
  rm          Remove one or more containers
  rmi         Remove one or more images from local storage
  run         Run a command in a new container
  save        Save image(s) to an archive
  search      Search registry for image
  secret      Manage secrets
  start       Start one or more containers
  stats       Display a live stream of container resource usage statistics
  stop        Stop one or more containers
  system      Manage podman
  tag         Add an additional name to a local image
  top         Display the running processes of a container
  unpause     Unpause the processes in one or more containers
  untag       Remove a name from a local image
  update      Update an existing container
  version     Display the Podman version information
  volume      Manage volumes
  wait        Block on one or more containers

Options:
      --config string             Path to directory containing authentication config file
  -c, --connection string         Connection to use for remote Podman service (CONTAINER_CONNECTION)
      --help                      Help for podman
      --identity string           path to SSH identity file, (CONTAINER_SSHKEY)
      --log-level string          Log messages above specified level (trace, debug, info, warn, warning, error, fatal, panic) (default "warn")
      --out string                Send output (stdout) from podman to a file
      --ssh string                define the ssh mode (default "golang")
      --storage-opt stringArray   Used to pass an option to the storage driver
      --tls-ca string             path to TLS certificate Authority PEM file for remote.
      --tls-cert string           path to TLS client certificate PEM file for remote.
      --tls-key string            path to TLS client certificate private key PEM file for remote.
      --url string                URL to access Podman service (CONTAINER_HOST) (default "unix:///run/user/1100/podman/podman.sock")
  -v, --version                   version for podman-remote
Options (13)
OptionDescriptionSource
--config stringPath to directory containing authentication config filehelp
-c, --connection stringConnection to use for remote Podman service (CONTAINER_CONNECTION)help
--helpHelp for podmanhelp
--identity stringpath to SSH identity file, (CONTAINER_SSHKEY)help
--log-level stringLog messages above specified level (trace, debug, info, warn, warning, error, fatal, panic) (default "warn")help
--out stringSend output (stdout) from podman to a filehelp
--ssh stringdefine the ssh mode (default "golang")help
--storage-opt stringArrayUsed to pass an option to the storage driverhelp
--tls-ca stringpath to TLS certificate Authority PEM file for remote.help
--tls-cert stringpath to TLS client certificate PEM file for remote.help
--tls-key stringpath to TLS client certificate private key PEM file for remote.help
--url stringURL to access Podman service (CONTAINER_HOST) (default "unix:///run/user/1100/podman/podman.sock")help
-v, --versionversion for podman-remotehelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.