Commit Graph

228 Commits

Author SHA1 Message Date
Pablo Méndez Hernández
072018096d docs(podman-systemd.unit.5.md): Fix variable syntax
Fix variable syntax when referencing UID.

Signed-off-by: Pablo Méndez Hernández <pablomh@redhat.com>
2026-02-22 23:05:48 +01:00
Paul Holzinger
f4aa01967e Merge pull request #28099 from Honny1/quadlets-restart-pod
Respect user-specified `Restart=` policy in pod units
2026-02-17 12:49:20 +01:00
mhorky
9b611b5380 docs(quadlet): Unify [Network] section on removal
The original text was added in 518daef in 2023-08. Later, in 0d4a148
in 2025-04, a new option has been introduced without the text being
updated.

Signed-off-by: mhorky <mhorky@redhat.com>
2026-02-17 08:16:49 +01:00
Jan Rodák
33e8abd637 Respect user-specified Restart= policy in pod units
Fixes: https://github.com/containers/podman/issues/28081

Signed-off-by: Jan Rodák <hony.com@seznam.cz>
2026-02-16 22:12:18 +01:00
axel7083
2369ed4b71 docs(podman-systemd.unit.5.md): remove false claim on Pods HostName key
Fixes https://github.com/containers/podman/issues/28089

Signed-off-by: axel7083 <42176370+axel7083@users.noreply.github.com>
2026-02-13 14:49:47 +01:00
Šimon Brauner
9727a43f5a Added setting UID and GID for volumes in quadlet
Related: https://issues.redhat.com/browse/RHEL-145863

Signed-off-by: Šimon Brauner <sbrauner@redhat.com>
2026-02-11 18:16:30 +01:00
Bryan Parry
f96e0a3fb2 Fix podman run equivalent for HealthStartPeriod
Signed-off-by: Bryan Parry <bparry@redhat.com>
2026-01-14 15:48:52 -05:00
Ashley Cui
73d6be2876 Merge pull request #27835 from kriansa/fix-timeoutstartsec-docs
docs: fix misleading TimeoutStartSec information for oneshot services
2026-01-14 11:49:03 -05:00
Matthijs Kooijman
7a87456fdd Fix docs for Volume User= and Group= options
These are not options directly passed to `--opt`, but these use `--opt o=`, so update the table accordingly.

Signed-off-by: Matthijs Kooijman <matthijs@stdin.nl>
2026-01-05 17:52:39 +01:00
Daniel Pereira
e6c3e4f411 docs: fix misleading TimeoutStartSec information for oneshot services
The documentation incorrectly stated that TimeoutStartSec "cannot be
used" with Type=oneshot services. According to systemd.service(5),
the startup timeout is simply disabled by default (set to infinity)
for oneshot services, but TimeoutStartSec can still be explicitly
configured if a timeout is desired.

Signed-off-by: Daniel Pereira <zdaniel.gp@gmail.com>
2025-12-28 14:15:50 -03:00
Salim B
7b30d9cd3f docs: further tweaks
Signed-off-by: Salim B <git@salim.space>
2025-11-22 01:17:47 +01:00
Salim B
d1c2afc941 docs: improve note about Quadlet TimeoutStartSec
Signed-off-by: Salim B <git@salim.space>
2025-11-22 00:51:01 +01:00
Erik Sjölund
7741e047dd podman-systemd.unit.5: document /sbin/nologin accounts
Add command:
sudo systemctl --machine username@ --user list-unit-files

Fixes: https://github.com/containers/podman/issues/27544

Co-authored-by: Tom Sweeney <tsweeney@redhat.com>
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2025-11-20 21:01:42 +01:00
givensuman
e7b50c33df Add AppArmor key to quadlet .container files
Fixes: #27095
Signed-off-by: givensuman <givensuman@duck.com>
2025-11-05 18:15:52 -05:00
Brent Baude
183ed100a6 Escape periods in path
Unescaped periods in things like paths in tables can trigger failed man
page builds.

Signed-off-by: Brent Baude <bbaude@redhat.com>
2025-10-27 15:41:55 -05:00
axel7083
8e013c0012 feat(quadlet: kube): support multiple Yaml entries
fixes https://github.com/containers/podman/issues/26274

Signed-off-by: axel7083 <42176370+axel7083@users.noreply.github.com>
2025-10-22 16:09:47 +02:00
openshift-merge-bot[bot]
f2a559a8fe Merge pull request #27309 from ygalblum/quadlet-build-ignorefile
Quadlet build - add support for IgnoreFile key
2025-10-17 15:37:32 +00:00
Ygal Blum
1800b34b51 Quadlet build - add support for IgnoreFile key
Resolves: https://github.com/containers/podman/issues/27268

Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-10-16 14:02:04 -04:00
openshift-merge-bot[bot]
ba4d836044 Merge pull request #27256 from givensuman/T-27065-add-quadlet-build-args-support
Add BuildArg key to quadlets
2025-10-16 15:24:52 +00:00
openshift-merge-bot[bot]
32d6c54054 Merge pull request #26624 from Odilhao/artifact-quadlet-implementation
Add artifact quadlet unit type support
2025-10-13 14:41:25 +00:00
givensuman
1e713c1a5f Add BuildArg example into documentation
Signed-off-by: givensuman <givensuman@duck.com>
2025-10-10 13:25:04 -04:00
Odilon Sousa
34254cd1d0 Add artifact quadlet unit type support
RFE: Add artifact quadlet unit type #25778

Signed-off-by: Odilon Sousa <osousa@redhat.com>
2025-10-10 11:08:33 -03:00
givensuman
b4d81c0338 Run make validatepr
Signed-off-by: givensuman <givensuman@duck.com>
2025-10-09 09:45:11 -04:00
given
c0a09e7f10 Update docs/source/markdown/podman-systemd.unit.5.md
Co-authored-by: Tom Sweeney <tsweeney@redhat.com>
Signed-off-by: givensuman <givensuman@duck.com>
2025-10-09 09:44:53 -04:00
ByoungUk Lee
e3c9fa6ddd Update docs for StopTimeOut
Signed-off-by: ByoungUk Lee <nimdrak@gmail.com>
2025-10-09 01:52:26 +00:00
givensuman
a696f8bccb Update documentation to include BuildArg key
Signed-off-by: givensuman <givensuman@duck.com>
2025-10-08 13:31:30 -04:00
Paul Holzinger
070d7c3ad3 Revert "Rewrite the Quadlet documentation."
This reverts commit c12b1b32bc.

The content contains incorrect information and misses a lot of details
from the previous page that must be restored.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-09-11 19:00:19 +02:00
Paul Holzinger
4ae8e386ef Revert "docs: restore podman-systemd.unit.5"
This reverts commit cab3c6de6d.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-09-11 18:59:11 +02:00
Paul Holzinger
cab3c6de6d docs: restore podman-systemd.unit.5
There are endless of links pointing to this document we should not get
rid of that.
Also I find having two podman-quadlet with different numbers rather
confusing, while I understand the motivation I think for most users this
is not intuitive. Most people will not type the man section numbers.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-09-05 18:59:19 +02:00
Jan Kaluza
c12b1b32bc Rewrite the Quadlet documentation.
This commit does the following:

- Splits the podman-systemd.unit.5.md into multiple files - one for each
  quadlet file type, podman-quadlet.7.md for general quadlet information
  and podman-quadlet-basic-usage.7.md for quadlet examples.
- Removes the original podman-systemd.unit.5.md file.
- Adds support for jinja2 templating language in the markdown_preprocess.
- Uses jinja2 in options/*.md to use the single .md file for both podman
  subcommands man-pages and quadlet man-pages. This deduplicates
  the Quadlet man-pages a lot.
- Adds new `@@option quadlet:source.md` preprocess command to import
  such .md files from options directory.

Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
2025-09-02 12:49:45 +02:00
Ondřej Gajdušek
c65fd9a2c2 quadlet: add HttpProxy option for Container sections
Add support for HttpProxy key in quadlet Container sections to control
proxy environment variable inheritance during image pulls and builds.

- HttpProxy=true enables proxy inheritance (default podman behavior)
- HttpProxy=false disables proxy inheritance
- When omitted, uses podman's default behavior

This addresses the need for declarative proxy configuration in IPv6-only
networks and other scenarios where proxy settings need to be controlled
at the container level without manual workarounds.

Fixes #26925

Signed-off-by: Ondřej Gajdušek <ogajduse@redhat.com>
2025-09-01 13:45:06 +02:00
Albert Esteve
ca3347cc2b doc(podman-system.unit.5.md): clarify user/group
Clarify User= and Group= quadlet options
when used simultaneously.

Signed-off-by: Albert Esteve <aesteve@redhat.com>
2025-08-04 16:19:56 +02:00
Ygal Blum
439448c287 Quadlet - add support for the Policy key for .image files
Resolves: #26446

Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-07-10 13:06:38 -04:00
Evan Miller
4b1f7bcb9a Quadlet - Error when units define User, Group, or DynamicUser in Service group
Fixes: #26543

Signed-off-by: Evan Miller <miller.evan815@gmail.com>
2025-07-02 00:34:46 -07:00
nbspsemicolon
5989370c39 pkg/systemd: expose [Pod] ExitPolicy key for pod create --exit-policy
Add ExitPolicy key to pod quadlets with logic to default to stop.

Docs updated with clarifcation on default value and usage example.

Simple assert added to bats to verify default constraint exists.

Changed argument order in ginkgo basic pod unit test

Signed-off-by: Neil Bailey <nbsp@nbailey.net>
2025-06-18 15:08:31 -04:00
Paul Holzinger
a0f7db44e8 quadlet: add InterfaceName option to network unit
I noticed this was missing, its a simple 1 to 1 mapping to
--interface-name.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-06-04 16:46:39 +02:00
Paul Holzinger
f2d941b241 docs: quadlet can translate names now
Remove no longer correct statement that quadlet that does not translate
our own custom unit types

Fixes: e498c652 ("Quadlet - translate dependencies on other quadlet units")
Fixes: #26243

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-05-30 18:06:03 +02:00
Ygal Blum
700c679cd2 Quadlet - Update the docs to reflect the default naming of resources
Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-05-12 09:33:28 -04:00
Robin Heinemeier
802fc15b1e Add Label to quadlet pod
Signed-off-by: Robin Heinemeier <sunnerlp@gmail.com>
2025-04-24 13:37:42 +00:00
openshift-merge-bot[bot]
5372c15bf8 Merge pull request #25892 from Regis-Caelum/quadlet-pod-hostname
Add HostName to quadlet pod
2025-04-22 12:52:04 +00:00
Inshal Khan
4ba8cde41d Add HostName to quadlet pod
update docs for hostname

Signed-off-by: Inshal Khan <kziaul123@gmail.com>
2025-04-19 08:51:45 +05:30
openshift-merge-bot[bot]
edcac9e9de Merge pull request #25901 from eulores/patch-1
Update podman-systemd.unit.5.md
2025-04-16 21:06:36 +00:00
openshift-merge-bot[bot]
17f3aed4fd Merge pull request #25899 from ygalblum/quadlet-unit-deps
Quadlet - translate dependencies on other quadlet units
2025-04-16 21:03:52 +00:00
Andreas
bc9110c69f Update podman-systemd.unit.5.md
Table header in Pod units section was referring to podman container... instead of podman pod...

Signed-off-by: Andreas <43118918+eulores@users.noreply.github.com>
2025-04-16 21:52:11 +02:00
Ygal Blum
e498c6526b Quadlet - translate dependencies on other quadlet units
Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-04-16 15:29:42 -04:00
openshift-merge-bot[bot]
09c2546b27 Merge pull request #25844 from ygalblum/quadlet-network-delete
Quadlet - allow deleting the network when stopping the service
2025-04-14 17:57:45 +00:00
Ygal Blum
0d4a148ee6 Quadlet - allow deleting the network when stopping the service
Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-04-10 10:34:16 -04:00
Ygal Blum
fe107ff0ce Quadlet - Add support for adding ExecReload command
Add tests
Update man page

Signed-off-by: Ygal Blum <ygal.blum@gmail.com>
2025-04-09 14:40:41 -04:00
Erik Sjölund
a96b29b58c docs: update DefaultDependencies description
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2025-04-08 18:19:59 +02:00
John Schug
a0cae65c13 quadlet: add support for the UpheldBy option in the Install section
This adds support for the UpheldBy option in quadlet files. The UpheldBy option
is the counterpart to the Upholds option added in systemd v249 and is
similar to the existing WantedBy and RequiredBy options.

See https://www.freedesktop.org/software/systemd/man/latest/systemd.unit.html#Upholds=.

Signed-off-by: John Schug <john.ips.schug@gmail.com>
2025-03-27 15:48:46 -07:00