Files
.fmf
.github
cmd
cni
completions
contrib
dependencies
docker
docs
source
_static
locale
markdown
links
options
.gitignore
podman-attach.1.md.in
podman-auto-update.1.md.in
podman-build.1.md.in
podman-commit.1.md
podman-completion.1.md
podman-compose.1.md.in
podman-container-checkpoint.1.md
podman-container-cleanup.1.md
podman-container-clone.1.md.in
podman-container-diff.1.md.in
podman-container-exists.1.md
podman-container-inspect.1.md.in
podman-container-prune.1.md
podman-container-restore.1.md
podman-container-runlabel.1.md.in
podman-container.1.md
podman-cp.1.md
podman-create.1.md.in
podman-diff.1.md.in
podman-events.1.md
podman-exec.1.md.in
podman-export.1.md
podman-farm-build.1.md.in
podman-farm-create.1.md
podman-farm-list.1.md
podman-farm-remove.1.md
podman-farm-update.1.md
podman-farm.1.md
podman-generate-spec.1.md
podman-generate-systemd.1.md
podman-generate.1.md
podman-healthcheck-run.1.md
podman-healthcheck.1.md
podman-history.1.md
podman-image-diff.1.md
podman-image-exists.1.md
podman-image-inspect.1.md
podman-image-mount.1.md
podman-image-prune.1.md
podman-image-scp.1.md
podman-image-sign.1.md.in
podman-image-tree.1.md
podman-image-trust.1.md.in
podman-image-unmount.1.md
podman-image.1.md
podman-images.1.md.in
podman-import.1.md
podman-info.1.md
podman-init.1.md.in
podman-inspect.1.md.in
podman-kill.1.md.in
podman-kube-apply.1.md
podman-kube-down.1.md
podman-kube-generate.1.md
podman-kube-play.1.md.in
podman-kube.1.md
podman-load.1.md
podman-login.1.md.in
podman-logout.1.md.in
podman-logs.1.md.in
podman-machine-info.1.md
podman-machine-init.1.md.in
podman-machine-inspect.1.md
podman-machine-list.1.md.in
podman-machine-os-apply.1.md
podman-machine-os.1.md
podman-machine-reset.1.md
podman-machine-rm.1.md
podman-machine-set.1.md.in
podman-machine-ssh.1.md
podman-machine-start.1.md
podman-machine-stop.1.md
podman-machine.1.md
podman-manifest-add.1.md.in
podman-manifest-annotate.1.md.in
podman-manifest-create.1.md.in
podman-manifest-exists.1.md
podman-manifest-inspect.1.md.in
podman-manifest-push.1.md.in
podman-manifest-remove.1.md
podman-manifest-rm.1.md
podman-manifest.1.md
podman-mount.1.md.in
podman-network-connect.1.md
podman-network-create.1.md
podman-network-disconnect.1.md
podman-network-exists.1.md
podman-network-inspect.1.md
podman-network-ls.1.md.in
podman-network-prune.1.md
podman-network-reload.1.md.in
podman-network-rm.1.md
podman-network-update.1.md
podman-network.1.md
podman-pause.1.md.in
podman-pod-clone.1.md.in
podman-pod-create.1.md.in
podman-pod-exists.1.md
podman-pod-inspect.1.md.in
podman-pod-kill.1.md.in
podman-pod-logs.1.md.in
podman-pod-pause.1.md
podman-pod-prune.1.md
podman-pod-ps.1.md.in
podman-pod-restart.1.md
podman-pod-rm.1.md.in
podman-pod-start.1.md.in
podman-pod-stats.1.md.in
podman-pod-stop.1.md.in
podman-pod-top.1.md.in
podman-pod-unpause.1.md
podman-pod.1.md
podman-port.1.md.in
podman-ps.1.md
podman-pull.1.md.in
podman-push.1.md.in
podman-remote.1.md
podman-rename.1.md
podman-restart.1.md.in
podman-rm.1.md.in
podman-rmi.1.md
podman-run.1.md.in
podman-save.1.md.in
podman-search.1.md.in
podman-secret-create.1.md
podman-secret-exists.1.md
podman-secret-inspect.1.md
podman-secret-ls.1.md.in
podman-secret-rm.1.md
podman-secret.1.md
podman-start.1.md.in
podman-stats.1.md.in
podman-stop.1.md.in
podman-system-connection-add.1.md
podman-system-connection-default.1.md
podman-system-connection-list.1.md
podman-system-connection-remove.1.md
podman-system-connection-rename.1.md
podman-system-connection.1.md
podman-system-df.1.md
podman-system-migrate.1.md
podman-system-prune.1.md
podman-system-renumber.1.md
podman-system-reset.1.md
podman-system-service.1.md
podman-system.1.md
podman-systemd.unit.5.md
podman-tag.1.md
podman-top.1.md.in
podman-unmount.1.md.in
podman-unpause.1.md.in
podman-unshare.1.md
podman-untag.1.md
podman-update.1.md.in
podman-version.1.md
podman-volume-create.1.md
podman-volume-exists.1.md
podman-volume-export.1.md
podman-volume-import.1.md
podman-volume-inspect.1.md
podman-volume-ls.1.md.in
podman-volume-mount.1.md
podman-volume-prune.1.md
podman-volume-reload.1.md
podman-volume-rm.1.md
podman-volume-unmount.1.md
podman-volume.1.md
podman-wait.1.md.in
podman.1.md
podmansh.1.md
Commands.rst
Introduction.rst
Reference.rst
Search.rst
Tutorials.rst
conf.py
includes.rst
index.rst
volume.rst
tutorials
MANPAGE_SYNTAX.md
Makefile
README.md
dckrman.sh
kubernetes_support.md
links-to-html.lua
make.bat
play.png
podman-derivative-api
remote-docs.sh
requirements.txt
standalone-styling.css
use-pagetitle.lua
hack
libpod
logo
pkg
plans
rpm
test
utils
vendor
version
.cirrus.yml
.dockerignore
.gitignore
.golangci.yml
.packit.sh
.packit.yaml
.pre-commit-config.yaml
.readthedocs.yaml
CODE-OF-CONDUCT.md
CONTRIBUTING.md
DISTRO_PACKAGE.md
DOWNLOADS.md
ISSUE-EOL-POLICY.md
LICENSE
Makefile
OWNERS
README.md
RELEASE_NOTES.md
RELEASE_PROCESS.md
SECURITY.md
Vagrantfile
build_osx.md
build_windows.md
commands-demo.md
commands.md
go.mod
go.sum
install.md
pyproject.toml
rootless.md
transfer.md
troubleshooting.md
winmake.ps1
podman/docs/source/markdown/podman-init.1.md.in
Daniel J Walsh d3a49fdedb Add information about --latest support on man pages
On Mac and Windows systems the --latest option is not supported
this PR mentions this fact in the examples section of the man page.
Also added documentation and consistency to the man pages examples
sections.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2024-01-23 07:28:40 -05:00

48 lines
1.5 KiB
Markdown

% podman-init 1
## NAME
podman\-init - Initialize one or more containers
## SYNOPSIS
**podman init** [*options*] *container* [*container*...]
**podman container init** [*options*] *container* [*container*...]
## DESCRIPTION
Initialize one or more containers.
You may use container IDs or names as input.
Initializing a container performs all tasks necessary for starting the container (mounting filesystems, creating an OCI spec, initializing the container network) but does not start the container.
If a container is not initialized, the `podman start` and `podman run` commands initialize it automatically prior to starting it.
This command is intended to be used for inspecting a container's filesystem or OCI spec prior to starting it.
This can be used to inspect the container before it runs, or debug why a container is failing to run.
## OPTIONS
#### **--all**, **-a**
Initialize all containers. Containers that have already initialized (including containers that have been started and are running) are ignored.
@@option latest
## EXAMPLE
Initialize specified container with a given ID.
```
podman init 35480fc9d568
```
Initialize specified container with a given name.
```
podman init test1
```
Initialize the latest container. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
```
podman init --latest
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-start(1)](podman-start.1.md)**
## HISTORY
April 2019, Originally compiled by Matthew Heon <mheon@redhat.com>