3326 Commits

Author SHA1 Message Date
ab5e400a9a docs: remove remote limitation note for --build-context option
- Removal of a note in the build-context documentation about remote Podman client limitations
- Removal of skip statements for build-context tests in the test suite

Pull request #26628 adds support for --build-context for the remote client.

Signed-off-by: Jan Rodák <hony.com@seznam.cz>
2025-09-15 15:50:02 +02:00
8d06a9e9f7 fix: Correct typo in chrootdirs option
In explanation of chrootdirs option, leading / is dropped
from podman managed file path (/etc/hostname). So this PR
adds leading /.

Signed-off-by: Vanou Ishii <ishii.vanou@fujitsu.com>
2025-09-13 14:09:04 +09:00
070d7c3ad3 Revert "Rewrite the Quadlet documentation."
This reverts commit c12b1b32bc165766c1aa229ca05432c75cc74c3b.

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
bb422c8372 Revert "Change the syntax to not depend on jinja2."
This reverts commit 9de737bf29eba1606c1aff560e2cbba4fa1576e4.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-09-11 19:00:17 +02:00
fd60d63bf4 Revert "Deduplicate more options."
This reverts commit 6756eb34129381707626ec45761799ac5623dc5c.

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

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-09-11 18:59:11 +02:00
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
6756eb3412 Deduplicate more options.
Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
2025-09-05 15:26:16 +02:00
9de737bf29 Change the syntax to not depend on jinja2.
Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
2025-09-02 16:04:34 +02:00
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
428c854be6 Merge pull request #26932 from ogajduse/feature/quadlet-httpproxy-26925
quadlet: add HttpProxy option for Container sections
2025-09-01 16:04:15 +00:00
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
dedeb24e9f Merge pull request #26931 from jelly/mention-zst
Mention zstandard tarball import support
2025-08-29 17:39:28 +00:00
b9812e3d9e Mention zstandard tarball import support
The `podman-import` man page already mentions support for zstd
compressed tarball support but the cli output didn't.

Signed-off-by: Jelle van der Waa <jvanderwaa@redhat.com>
2025-08-29 17:51:04 +02:00
dc1ccba6cb Merge pull request #26813 from fiesh/improve-documentation
Improve dns documentation
2025-08-29 15:08:19 +00:00
68b6876481 Merge pull request #26895 from intirix/tcp-close
Add support for criu's tcp-close functionality.
2025-08-28 10:40:59 +00:00
9c3652c188 Add support for criu's tcp-close functionality.
Fixes: #26676
Signed-off-by: Jeff Mercer <jeff.mercer@gmail.com>
2025-08-27 18:52:34 -04:00
835c581c4b Merge pull request #26737 from arsenalzp/podman-26691
Podman wait condition for return of first container
2025-08-27 16:03:29 +00:00
3548ae1caf Merge pull request #26853 from shiavm006/issue-1
ocs(run,create): document remote transport limitations for oci-archive/docker-archive/docker-daemon
2025-08-21 21:11:17 +00:00
249fa21e8a Improve documentation wording
Relax _will_ to _may_ and add a clarifying _then_.

Furthermore, we add a paragraph describing the behavior of the `--dns`
command line option.  This references #26812.

Signed-off-by: Christoph Weiss <weiss@wsoptics.de>
2025-08-20 17:23:40 +02:00
a91d5f033f Merge pull request #26834 from shiavm006/bugfix-1
docs: add missing groups and hgroups descriptors to podman top documentation
2025-08-19 14:33:38 +00:00
83ae19246e Merge pull request #26831 from Raghul-M/connection-add
docs: Add missing flag examples to podman system connection add man page
2025-08-19 14:30:47 +00:00
cdc2d4e17c Merge pull request #26838 from Raghul-M/podmanrm
docs: Add missing --ignore flag example to podman rm man page
2025-08-18 18:26:08 +00:00
e8a40a3994 Merge pull request #26825 from Raghul-M/commands_manpages
docs: Add --format flag examples to commands in man pages
2025-08-18 16:55:12 +00:00
96d9a00adb docs(run,create): note remote clients support only docker transport
On remote clients (incl. Mac/Windows, excl. WSL2), file-based transports (oci-archive:, docker-archive:, docker-daemon:) are not supported. Also fix trailing whitespace per pre-commit.

Signed-off-by: shiavm006 <shivammittal42006@gmail.com>
2025-08-18 18:45:08 +05:30
e1d6dfd2c7 Fixes #26369
Signed-off-by: Raghul-M <raghul.m1430@gmail.com>
2025-08-16 01:30:20 +05:30
46ee62ca6a Fixes: #26353
Signed-off-by: Raghul-M <raghul.m1430@gmail.com>
2025-08-15 23:14:24 +05:30
8674775039 Merge pull request #26826 from Raghul-M/systemsocket_manpage
docs: Add custom socket path example to podman system service man page
2025-08-15 17:29:44 +00:00
3dddd21188 Merge pull request #26766 from kwentine/patch-1
docs: Typos
2025-08-15 17:07:51 +00:00
c33af3c8dd docs: add missing groups and hgroups descriptors to podman-top documentation
Signed-off-by: shiavm006 <shivammittal42006@gmail.com>
2025-08-15 19:46:56 +05:30
fda74ee619 added system-connection-add options example
Signed-off-by: Raghul-M <raghul.m1430@gmail.com>
2025-08-15 16:42:02 +05:30
21f2128d79 added example for custom socket
Signed-off-by: Raghul-M <raghul.m1430@gmail.com>
2025-08-14 23:37:57 +05:30
fb294e91df Merge pull request #26740 from mohitjain1911/feature/filter-flag-docs-26351
Manpages: Add --filter flag usage examples to various commands #26351
2025-08-14 15:14:03 +00:00
f38e32760d feat: Add artifact remove --all option
Prior to this commit `artifact remove --all` was not supported on remote
clients.

This patch adds a new artifact API endpoint `artifact/remove` which can
either take a list of artifacts to remove or remove all artifacts by
setting all=true.

This patch removes the temporary warning message in the tunnel interface
implementation of ArtifactRm if `--all` was passed on the command line
and uses the new `artifact/remove` endpoint.

This patch also updates the `artifact remove` command both remote and
local to accept a list of artifacts to remove rather than limiting to
just one.

Signed-off-by: Lewis Roy <lewis@redhat.com>
2025-08-13 23:00:20 +10:00
a9e80f9d6d Merge pull request #26785 from Luap99/user-mode-docs
make machine --user-mode-networking docs more clear
2025-08-11 21:13:50 +00:00
6ab595814d Merge pull request #26732 from shiavm006/docs-pod-create-examples-only
docs: add examples with resource limits and mounts
2025-08-11 18:56:40 +00:00
5706d2a61e make machine --user-mode-networking docs more clear
The docs were outdated mentioning the qemu backed for Mac and I find the
way they are written to be a bit confusing.

I think it is best to start with that this option is not supported on
all the providers except WSL.

Fixes: #26780

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2025-08-11 17:27:18 +02:00
9f7af81cf8 Merge pull request #26718 from ninja-quokka/machine_init_tls_verify
Add support for configuring tls verification with machine init
2025-08-09 16:25:14 +00:00
7247d84fbe Fix typo
Signed-off-by: Quentin Ågren <quentin.agren@gmail.com>
2025-08-07 07:28:06 +02:00
a75f74b1d3 Fixes: #26691
Signed-off-by: Oleksandr Krutko <alexander.krutko@gmail.com>
2025-08-06 22:34:18 +03:00
a97d90c89b Merge pull request #26728 from TomSweeneyRedHat/dev/tsweeney/killexperimental
[CI:DOCS] Remove Experimental from Artifacts man pages
2025-08-06 18:06:30 +00:00
b5fce87237 Manpages: Added --filter flag examples to all the relevant podman
manpages

Signed-off-by: mohitjain1911 <mohitjain19113@gmail.com>

Manpages: Added --filter examples to podman-stop.1.md.in

Signed-off-by: mohitjain1911 <mohitjain19113@gmail.com>

Manpages: Added examples for --filter flag for 'podman start'  command in podman-start.1.md.in

Signed-off-by: mohitjain1911 <mohitjain19113@gmail.com>

Manpages: Added examples for --filter flag for 'podman rm'  command in podman-rm.1.md.in

Signed-off-by: mohitjain1911 <mohitjain19113@gmail.com>

Manpages: Added examples for --filter flag for 'podman restart' command in podman-restart.1.md.in

Signed-off-by: mohitjain1911 <mohitjain19113@gmail.com>

Manpages: Added examples for --filter flag for 'podman pod ps' command in podman-pod-ps.1.md.in

Signed-off-by: mohitjain1911 <mohitjain19113@gmail.com>

Manpages: Added examples for --filter flag for 'podman system prune' command in podman-system-prune.1.md

Signed-off-by: mohitjain1911 <mohitjain19113@gmail.com>
2025-08-05 18:12:14 +05:30
7c95ceae57 Manpages: podman container runlabel added example with --replace
Signed-off-by: mohitjain1911 <mohitjain19113@gmail.com>
2025-08-05 18:04:37 +05:30
43ea8337c1 Merge pull request #26742 from aesteve-rh/fix-doc
doc(podman-system.unit.5.md): clarify user/group
2025-08-05 11:53:00 +00:00
67ec2037c0 Add support for configuring tls verification with machine init
This patch adds a new --tls-verify flag to the `podman machine init`
sub command which matches many of our other commands. This allows the
user to optionally control whether TLS verification is enabled or
disabled for download of the machine image.

The default remains to leave the TLS verification decision to the
backend library which defaults to enabling it, this patch just
allows the user to explicitly set it on the CLI.

Fixes: #26517

Signed-off-by: Lewis Roy <lewis@redhat.com>
2025-08-05 21:02:28 +10:00
08f048066d Merge pull request #26720 from TusharMohapatra07/main
`feat:` add support for label filter with key only
2025-08-04 15:51:20 +00:00
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
f96eccb1ac docs: add examples with resource limits and mounts to podman pod create manpage
Add comprehensive examples showing shared resource limits and volume mounts
for all containers in a pod. This addresses the missing examples for resource limits and mounts in the
podman pod create manpage.

Signed-off-by: shiavm006 <shivammittal42006@gmail.com>
2025-08-01 23:10:05 +05:30
4a7974a7a8 [CI:DOCS] Remove Experimental from Artifacts man pages
Remove the "Experimental" stanza from the Podman Artifact commands
in time for Podman v5.6 and RHEL 9.7/10.1

Signed-off-by: tomsweeneyredhat <tsweeney@redhat.com>
2025-07-31 18:39:25 -04:00
5ab92a7499 docs(kube play): clarify --annotation flag only affects containers, not pods
Signed-off-by: shiavm006 <shivammittal42006@gmail.com>
2025-07-31 20:17:19 +05:30