diff --git a/docs/source/markdown/podman-systemd.unit.5.md b/docs/source/markdown/podman-systemd.unit.5.md index d724fb6537..426614080f 100644 --- a/docs/source/markdown/podman-systemd.unit.5.md +++ b/docs/source/markdown/podman-systemd.unit.5.md @@ -85,14 +85,13 @@ or [DynamicUser](https://www.freedesktop.org/software/systemd/man/latest/systemd systemd options. If you want to run a rootless Quadlet, you will need to create the user and add the unit file to one of the above rootless unit search paths. -Note: When a Quadlet is starting, Podman often pulls or builds one more container images which may take a considerable amount of time. -Systemd defaults service start time to 90 seconds, or fails the service. Pre-pulling the image or extending -the systemd timeout time for the service using the *TimeoutStartSec* Service option can fix the problem. -A word of caution: *TimeoutStartSec* is not available for `Type=oneshot` units. Refer to `systemd.service(5)` -for more information on how to handle long startup times for units which do not need to stay active -once their main process has finished. +When a Quadlet unit starts, Podman may need to pull or build container images, which can take significantly longer +than systemd's default 90-second service startup limit. If this causes the unit to fail, you can either pre-pull the +required images or increase the service's startup timeout using the *TimeoutStartSec* option. Keep in mind, however, +that *TimeoutStartSec* cannot be used with units that specify `Type=oneshot` (their startup timeout is disabled by +default). For further details on *TimeoutStartSec*, see `systemd.service(5)`. -Adding the following snippet to a Quadlet file extends the systemd timeout to 15 minutes. +Adding the following snippet to a Quadlet file extends the startup timeout to 15 minutes. ``` [Service] @@ -2373,7 +2372,7 @@ Image=quay.io/example/my-app:latest Mount=type=artifact,source=my-artifact.artifact,destination=/etc/config ``` -Example for Container in a Pod: +Example for a container in a Pod: `test.pod` ``` @@ -2389,7 +2388,7 @@ Exec=sh -c "sleep inf" Pod=test.pod ``` -Example for a Pod with a oneshot Startup Task: +Example for a Pod with a one-shot startup task: `test.pod` ```