diff --git a/docs/source/markdown/podman-system-migrate.1.md b/docs/source/markdown/podman-system-migrate.1.md index 14b5e137b9d..f39ccf75641 100644 --- a/docs/source/markdown/podman-system-migrate.1.md +++ b/docs/source/markdown/podman-system-migrate.1.md @@ -32,6 +32,31 @@ Set a new OCI runtime for all containers. This can be used after a system upgrade which changes the default OCI runtime to move all containers to the new runtime. There are no guarantees that the containers continue to work under the new runtime, as some runtimes support differing options and configurations. +## EXAMPLES + +Normal invocation +```bash +### No output is expected from this command. +$ podman system migrate +``` + +Migration to a new OCI runtime (e.g., from crun to runc) +```bash +### Create a container using the current default runtime (e.g., crun) +$ podman create --name test-alpine alpine + +### Confirm the current runtime +$ podman container inspect test-alpine | grep OCIRuntime + "OCIRuntime": "crun", + +### Migrate all containers to use a new runtime (e.g., runc) +$ podman system migrate --new-runtime runc + +### Verify the container is now using the new runtime +$ podman container inspect test-alpine | grep OCIRuntime + "OCIRuntime": "runc", +``` + ## SEE ALSO **[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**, **usermod(8)**