podman(1) General Commands Manual podman(1) (NAME) podman - (SYNOPSIS) podman [] (DESCRIPTION) (Podman ) (Daemonless) . Docker-CLI . : alias docker=podman. . Buildah(1) . ( ) ( ). containers.conf . (Remote) containers.conf . systemd quadlet . podman-quadlet(1) podman-systemd.unit(5) . podman [ ] (GLOBAL OPTIONS) --cdi-spec-dir=path CDI ( ). /etc/cdi . --cgroup-manager=manager CGroup cgroup . cgroupfs systemd . systemd containers.conf . : CGroup . --config . docker . --conmon conmon ( containers.conf ). --connection, -c ( WSL2) ( containers.conf ). --remote true . containers.conf . --events-backend=type . file journald none. file /events/events.log ( --tmpdir ). --help, -h . --hooks-dir=path *.json (Hook) Podman . JSON oci-hooks(5) . Podman libpod 1.0.0 0.1.0 0.1.0 . ( oci-hooks(5) ). (Annotation) libpod OCI . bind-mount --volume . bind libpod ( /dev/shm) . --hooks-dir root Podman libpod /usr/share/containers/oci/hooks.d /etc/containers/oci/hooks.d . . --hooks-dir . Podman libpod precreate create . precreate . . : precreate . . libpod precreate . --identity=path SSH ( ). (passphrase) . . . : - - CONTAINER_SSHKEY CONTAINER_HOST - containers.conf containers.conf . --imagestore=path (imagestore) . graphroot imagestore imagestore graphroot . overlay graphroot . imagestore containers- storage.conf(5) containers- storage.conf(5) . --log-level=level : debug info warn error fatal panic (: warn). --module=path containers.conf(5). . containers.conf(5) . ( WSL2) . () Podman . --network-config-dir=directory . "/etc/containers/networks" "$graphroot/networks" . --out=path . dev/null/ . --log-driver . --remote, -r true Podman . false . containers.conf . CONTAINER_HOST --remote true . --root=value (: "/var/lib/containers/storage" UID 0 "$HOME/.local/share/containers/storage" ). containers-storage.conf(5) . storage.options. containers-storage.conf(5) STORAGE_OPTS . --storage-opt . --runroot=value (: "/run/containers/storage" UID 0 "/run/user/$UID/run" ). containers-storage.conf(5) . --runtime=value OCI containers.conf OCI . --runtime-flag=flag . (runc runc(8) cgroup V2 crun crun(8) ). containers.conf . : -- . --log-format json runc podman build --runtime-flag log- format=json . --ssh=value SSH golang --ssh=native ssh containers.conf . --storage-driver=value . containers- storage.conf(5) . STORAGE_DRIVER . --storage-driver . storage.options. containers-storage.conf(5) STORAGE_OPTS . --storage-opt . --storage-opt=value . containers-storage.conf(5) . STORAGE_OPTS . --storage-opt . ""=storage-opt-- . --root --storage-driver containers-storage.conf(5) STORAGE_OPTS . --syslog syslog ( false). ( WSL2) $HOME/.config/containers/podman.log . --tls-ca=path PEM (CA) . --tls-cert=path PEM TLS . --tls-key . --tls-details=path containers-tls-details.yaml(5) TLS . ( Go ). . --tls-key=path PEM --tls-cert. --tls-cert . --tmpdir=path (tmp) libpod. $XDG_RUNTIME_DIR/libpod/tmp /run/libpod/tmp . : tmpdir-- . TMPDIR . /var/tmp . --transient-store (Transient Storage) ( --runroot) . . . Podman ( ) . . podman volume ls . . podman system prune --external . Podman () . containers-storage.conf(5) . --url=value URL ( containers.conf unix:///run/user/$UID/podman/podman.sock unix:///run/podman/podman.sock). --remote true . o CONTAINER_HOST ://[]@][:][] . : - schema : * ssh (): unix(7) host port SSH * tcp: TCP host port * unix: unix(7) path - user root ( ssh) - password ( ssh) - host IP Podman (ssh tcp) - port 22 (ssh tcp) - path /run/podman/podman.sock /run/user/$UID/podman/podman.sock (unix) (ssh) URL: - - CONTAINER_HOST - engine.service_destinations containers.conf /usr/share/containers - unix:///run/podman/podman.sock containers.conf . URL : - unix:///run/podman/podman.sock - unix:///run/user/$UID/podman/podman.sock - ssh://notroot@localhost:22/run/user/$UID/podman/podman.sock - ssh://root@localhost:22/run/podman/podman.sock - tcp://localhost:34451 - tcp://127.0.0.1:34451 --version, -v . --volumepath=value (: "/var/lib/containers/storage/volumes" UID 0 "$HOME/.local/share/containers/storage/volumes" ). containers.conf . (ENVIRONMENT VARIABLES) env [engine] containers.conf . podman . CONTAINERS_CONF containers.conf. CONTAINERS_REGISTRIES_CONF registries.conf. CONTAINERS_STORAGE_CONF storage.conf. CONTAINER_CONNECTION --connection . --remote . CONTAINER_HOST --url . --remote . CONTAINER_SSHKEY --identity ssh . PODMAN_CONNECTIONS_CONF podman system connection add podman farm add ~/.config/containers/podman- connections.json . STORAGE_DRIVER --storage-driver. STORAGE_OPTS --storage-opt. containers-storage.conf(5) . --root --storage- driver . TMPDIR . /var/tmp . XDG_CONFIG_HOME (Rootless) XDG_CONFIG_HOME $HOME/.config/containers . XDG_DATA_HOME XDG_DATA_HOME $HOME/.local/share/containers/storage . XDG_RUNTIME_DIR ${XDG_RUNTIME_DIR}/containers . PODMAN_NO_PAUSE_PROCESS "0" (pause process) . . (REMOTE ACCESS) Podman --remote . SSH TCP . podman --remote --url --identity --log-level --connection . containers.conf . (EXIT CODES) podman . podman chroot : 125 : $ podman run --foo busybox; echo $? Error: unknown flag: --foo 125 126 : $ podman run busybox /etc; echo $? Error: container_linux.go:346: starting container process caused "exec: 126 127 : $ podman run busybox foo; echo $? Error: container_linux.go:346: starting container process caused "exec: 127 podman : $ podman run busybox /bin/sh -c 'exit 3'; echo $? 3 (COMMANDS) +----------------------+--------------------------------------------------------------------------------------------------------+ | | | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-artifact(1) | OCI. | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-attach(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-auto-update(1) | | | | | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-build(1) | | | | Containerfile. | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-farm(1) | | | | | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-commit(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-completion(1) | | | | (Completion) | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-compose(1) | Compose | | | compose. | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-container(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-cp(1) | / | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-create(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-diff(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-events(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-exec(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-export(1) | | | | tar. | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-generate(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-healthcheck(1) | (Healthcheck) | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-history(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-image(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-images(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-import(1) | tarball | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-info(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-init(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-inspect(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-kill(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-load(1) | () tar | | | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-login(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-logout(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-logs(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-machine(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-manifest(1) | | | | (Image Index). | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-mount(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-network(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-pause(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-kube(1) | | | | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-pod(1) | | | | (Pod). | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-port(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-ps(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-pull(1) | (Pull) . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-push(1) | (Push) | | | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-quadlet(1) | (Quadlets) | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-rename(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-restart(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-rm(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-rmi(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-run(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-save(1) | () | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-search(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-secret(1) | (Secrets) . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-start(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-stats(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-stop(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-system(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-tag(1) | () | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-top(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-unmount(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-unpause(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-unshare(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-untag(1) | () | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-update(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-version(1) | . | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-volume(1) | ( | | | ). | +----------------------+--------------------------------------------------------------------------------------------------------+ |podman-wait(1) | | | | . | +----------------------+--------------------------------------------------------------------------------------------------------+ (CONFIGURATION FILES) containers.conf (/usr/share/containers/containers.conf, /etc/containers/containers.conf, $HOME/.config/containers/containers.conf) . containers.conf . /usr/share/containers/containers.conf . /etc/containers/containers.conf . $HOME/.config/containers/containers.conf . . . containers.conf . CONTAINERS_CONF containers.conf . mounts.conf (/usr/share/containers/mounts.conf) mounts.conf podman run podman start () . /etc/containers/mounts.conf . $HOME/.config/containers/mounts.conf . containers-mounts.conf(5) . policy.json (/etc/containers/policy.json, $HOME/.config/containers/policy.json) ( ) . containers-policy.json(5) . registries.conf (/etc/containers/registries.conf, $HOME/.config/containers/registries.conf) registries.conf . $HOME/.config/containers/registries.conf . CONTAINERS_REGISTRIES_CONF registries.conf . storage.conf (/etc/containers/storage.conf, $HOME/.config/containers/storage.conf) storage.conf containers/storage . . $HOME/.config/containers/storage.conf . CONTAINERS_STORAGE_CONF storage.conf . (ROOTLESS MODE) . /etc/subuid /etc/subgid . . UID/GID . /etc/subuid /etc/subgid . : $ sudo usermod --add-subuids 10000-75535 USERNAME $ sudo usermod --add-subgids 10000-75535 USERNAME : $ echo USERNAME:10000:65536 >> /etc/subuid $ echo USERNAME:10000:65536 >> /etc/subgid subuid(5) subgid(5) . : (Whitespace) /etc/subuid /etc/subgid . XDG_DATA_HOME .local/share/containers/storage . pasta . HPC ( ) UID GID /etc/subuid /etc/subgid . UID . ignore_chown_errors containers-storage.conf(5) . chown UID . UID . . : Overlay (OverlayFS) 5.12.9 . fuse-overlayfs OverlayFS . fuse-overlayfs . fuse-overlayfs mount_program $HOME/.config/containers/storage.conf . storage.conf mount_program = "/usr/bin/fuse-overlayfs" [storage.options.overlay] . (NFS) ( : Lustre Spectrum Scale GPFS) . $HOME/.config/containers/storage.conf graphroot ( NFS) NFS . (SEE ALSO) containers-mounts.conf(5), containers.conf(5), containers- registries.conf(5), containers-storage.conf(5), buildah(1), oci- hooks(5), containers-policy.json(5), crun(1), runc(8), subuid(5), subgid(5), pasta(1), conmon(8), podman-quadlet(1), podman- systemd.unit(5) (Troubleshooting) podman-troubleshooting(7) . podman-rootless(7) . (HISTORY) Dan Walsh : dwalsh@redhat.com podman(1)