spiegel_podman/docs/tutorials
Grzegorz Szczepanczyk 1abe0a8f34 docs: clarify partial vs lazy image pulling
The performance tutorial calls Podman's zstd:chunked / eStargz support
"lazy pulling", which isn't accurate. By itself Podman only does partial
pulling: it skips layer content it already has, but the image is still
fully pulled before a container runs. Real lazy pulling, where the image
is mounted before the download finishes, needs an external snapshotter
such as stargz-snapshotter.

Rename the section to "partial pulling" and add a sentence spelling out
the difference, as @giuseppe suggested on the issue.

Fixes: #24947

Signed-off-by: Grzegorz Szczepanczyk <g.szczepanczyk@getprintbox.com>
2026-06-19 12:17:05 +02:00
..
basic_networking.md Document pasta forwarding mode for rootless bridge networks 2026-05-20 14:24:48 +02:00
image_signing.md source code comments and docs: fix typos, language, Markdown layout 2023-05-22 07:52:16 +02:00
mac_client.md [CI:DOCS] fix default branch links 2022-01-15 20:56:19 +01:00
mac_win_client.md Improve mac_win_client tutorial structure and links 2026-03-12 11:14:34 +01:00
macos_autostart.md Add tutorial for running podman machine on macOS startup 2026-03-12 11:13:27 +01:00
performance.md docs: clarify partial vs lazy image pulling 2026-06-19 12:17:05 +02:00
podman-derivative-api.md docs: update the podman logo 2022-08-07 09:11:53 +08:00
podman-for-windows.md Add command podman system hyperv-prep 2026-04-29 23:00:29 +02:00
podman-install-certificate-authority.md Import local certificates to machines on macOS and Linux 2026-05-01 00:42:52 +02:00
podman-win-install.jpg Update the Podman on Windows tutorial for 6.0.x 2026-01-16 11:48:57 +01:00
podman-wsl-term.jpg Update the Podman on Windows tutorial for 5.7.x 2026-01-13 12:49:33 +01:00
podman_bridge.png [CI:DOCS]basic networking guide 2021-02-18 13:21:33 -06:00
podman_macvlan.png [CI:DOCS]basic networking guide 2021-02-18 13:21:33 -06:00
podman_pod.png [CI:DOCS]basic networking guide 2021-02-18 13:21:33 -06:00
podman_rootless_default.png [CI:DOCS]basic networking guide 2021-02-18 13:21:33 -06:00
podman_tutorial.md Clarify inspect example in basic setup tutorial 2026-05-25 10:58:07 +02:00
podman_tutorial_cn.md Clarify inspect example in basic setup tutorial 2026-05-25 10:58:07 +02:00
qemu-remote-tutorial.md Fix language, typos and markdown layout 2023-07-24 11:18:25 +02:00
README.md Add tutorial for running podman machine on macOS startup 2026-03-12 11:13:27 +01:00
remote_client.md Update remote_client.md 2023-02-18 23:54:41 +08:00
rootless_tutorial.md Remove slirp4netns from documentation 2026-04-13 09:04:41 -04:00
socket_activation.md Remove slirp4netns from documentation 2026-04-13 09:04:41 -04:00

PODMAN logo

Podman Tutorials

Introduction Tutorial

Learn how to set up Podman and perform some basic commands with the utility.

Basic Setup and Use of Podman in a Rootless environment

The steps required to set up rootless Podman are enumerated.

Setup Mac/Windows

Special setup for running the Podman remote client on a Mac or Windows PC and connecting to Podman running on a Linux VM are documented.

Running Podman on macOS startup with launchd

How to automatically start a Podman machine at login on macOS using launchd LaunchAgents.

Remote Client

A brief how-to on using the Podman remote-client.

How to use libpod for custom/derivative projects

How the libpod API can be used within your own project.

Image Signing

Learn how to set up and use image signing with Podman.

Basic Networking

A basic guide to common network setups with Podman

Socket activation

Learn how to run containers that support socket activation.

Performance

Performance guide regarding Podman configuration and usage.