containers/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2026-02-05 06:45:31 +01:00
Code Issues Releases Wiki Activity

[DOCS] Update references common -> container-libs/common

Browse Source 
Signed-off-by: Lewis Roy <lewisdenny@me.com>
This commit is contained in:
Lewis Roy
2026-02-04 20:16:49 +10:00
parent fad519747e
commit fc18d3229d
26 changed files with 66 additions and 66 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
CONTRIBUTING.md
View File

@@ -37,7 +37,7 @@ Reproducers make finding and fixing issues much easier for maintainers.
The easier it is for us to reproduce a bug, the faster it'll be fixed!
Please don't include any private/sensitive information in your issue!
Security issues should NOT be reported via Github and should instead be reported via the process described [here](https://github.com/containers/common/blob/main/SECURITY.md).
Security issues should NOT be reported via Github and should instead be reported via the process described [here](https://github.com/containers/container-libs/blob/main/SECURITY.md).
## Working On Issues
@@ -248,7 +248,7 @@ For example:
```
Fixes: #00000
Fixes: https://github.com/containers/common/issues/00000
Fixes: https://github.com/containers/container-libs/issues/00000
Fixes: https://issues.redhat.com/browse/RHEL-00000
Fixes: RHEL-00000
```

4
DISTRO_PACKAGE.md
View File

@@ -29,7 +29,7 @@ This illustrates the subpackage breakdown as well as top-level dependencies.
Podman requires a *runtime*, a *runtime monitor*, a *pause process*,
and *networking tools*. In Fedora, some of these requirements are indirectly
specified via [containers-common](https://github.com/containers/common);
specified via [container-libs/common](https://github.com/containers/container-libs/tree/main/common);
the nested tree looks like this:
```
Podman
@@ -108,4 +108,4 @@ fine-tune config settings and dependencies.
You will probably be responsible for packaging this.
The best starting point is its
[RPM spec file](https://github.com/containers/common/blob/main/rpm/containers-common.spec).
[RPM spec file](https://github.com/containers/container-libs/blob/main/common/rpm/containers-common.spec).

4
README.md
View File

@@ -95,7 +95,7 @@ Podman uses OCI projects and best of breed libraries for different aspects:
- Networking: Networking support through use of [Netavark](https://github.com/containers/netavark) and [Aardvark](https://github.com/containers/aardvark-dns). Rootless networking is handled via [pasta](https://passt.top/passt) or [slirp4netns](https://github.com/rootless-containers/slirp4netns).
- Builds: Builds are supported via [Buildah](https://github.com/containers/buildah).
- Conmon: [Conmon](https://github.com/containers/conmon) is a tool for monitoring OCI runtimes, used by both Podman and CRI-O.
- Seccomp: A unified [Seccomp](https://github.com/containers/common/blob/main/pkg/seccomp/seccomp.json) policy for Podman, Buildah, and CRI-O.
- Seccomp: A unified [Seccomp](https://github.com/containers/container-libs/blob/main/common/pkg/seccomp/seccomp.json) policy for Podman, Buildah, and CRI-O.
## Podman Information for Developers
@@ -104,7 +104,7 @@ For blogs, release announcements and more, please checkout the [podman.io](https
**[Installation notes](install.md)**
Information on how to install Podman in your environment.
**[OCI Hooks Support](https://github.com/containers/common/blob/main/pkg/hooks/README.md)**
**[OCI Hooks Support](https://github.com/containers/container-libs/blob/main/common/pkg/hooks/README.md)**
Information on how Podman configures [OCI Hooks][spec-hooks] to run when launching a container.
**[Podman API](https://docs.podman.io/en/latest/_static/api.html)**

2
build_windows.md
View File

@@ -263,7 +263,7 @@ provider="hyperv"
```
Find the complete list of configuration options in the
[documentation](https://github.com/containers/common/blob/main/docs/containers.conf.5.md).
[documentation](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md).
### Create and start a podman machine

4
contrib/design-docs/podman6hld.md
View File

@@ -87,7 +87,7 @@ and an ugly bug, we added SQLite3 support. SQLite has been the default since 4.
[deprecation notice for Podman 5.7](https://issues.redhat.com/browse/RUN-3343), and remove this as an option for 6.0.
We must also remove code in Podman’s test suite that specifically tests BoltDB. There will be a small amount of work,
presumably cleanup, in [common](https://github.com/containers/common) as well.
presumably cleanup, in [container-libs](https://github.com/containers/container-libs) as well.
## **--network-cmd-path**
@@ -106,7 +106,7 @@ In Podman 6, Podman will no longer support Intel based Macs. You can read a [wi
# Configuration files {#configuration-files}
Podman 6 will address a long standing problem with our configuration files largely centered around the remote client.
When the remote client was introduced, [containers-common](https://github.com/containers/common) already existed. While we did introduce remote client
When the remote client was introduced, [container-lib/common](https://github.com/containers/container-libs/tree/main/common) already existed. While we did introduce remote client
related content to the containers.conf files, we did not take an overall look at how the remote client would impact our
configuration files. With the popularity of our Windows and Mac clients, this became more exacerbated and the
introduction of the “machine” function only made that worse. In Podman 6, we must make containers-common more aware

2
docs/MANPAGE_SYNTAX.md
View File

@@ -34,7 +34,7 @@ Many manpages include the OPTIONS **--all**, **-a** and/or **--latest**, **-l**.
Example for the first sentence: **podman command** is an example command.
Commands or files that are quoted from other podman manpages or podman repositories have to be linked to those. Non-podman commands are not to be linked.\
Example sentence: Use **[podman-run](podman-run.1.md)** or **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** for the problem.
Example sentence: Use **[podman-run](podman-run.1.md)** or **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** for the problem.
It should also be specified if the command can only be run as root. In addition, it should be described when a command, OPTION, or other content cannot be executed with the remote client or in combination with other commands, OPTIONS, or content. In this case, the following sentence is put at the end of a command, OPTION, or content:\
*IMPORTANT: This command/OPTION/content is not available with the command/OPTION/content/on the remote Podman client.*\

50
docs/source/locale/ja/LC_MESSAGES/markdown.po
View File

@@ -549,7 +549,7 @@ msgid ""
"leave it running) using a configurable key sequence. The default sequence"
" is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-"
"keys** OPTION, or specifying it in the `containers.conf` file: see "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" for more information."
msgstr ""
@@ -1088,7 +1088,7 @@ msgstr ""
msgid ""
"**[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, "
"**[podman-run(1)](podman-run.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr ""
#: ../../source/markdown/podman-auto-update.1.md:5
@@ -4585,7 +4585,7 @@ msgid ""
msgstr ""
#: ../../source/markdown/podman-build.1.md:1402
msgid "https://github.com/containers/common/blob/main/docs/containerignore.5.md"
msgid "https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md"
msgstr ""
#: ../../source/markdown/podman-build.1.md:1404
@@ -4640,9 +4640,9 @@ msgid ""
"**[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**,"
" **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, "
"**[podman-ps(1)](podman-ps.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, "
"**[Containerfile(5)](https://github.com/containers/common/blob/main/docs/Containerfile.5.md)**,"
"**[Containerfile(5)](https://github.com/containers/container-libs/blob/main/common/docs/Containerfile.5.md)**,"
" "
"**[containerignore(5)](https://github.com/containers/common/blob/main/docs/containerignore.5.md)**"
"**[containerignore(5)](https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md)**"
msgstr ""
#: ../../source/markdown/podman-build.1.md:1426
@@ -5150,7 +5150,7 @@ msgstr ""
#: ../../source/markdown/podman-events.1.md:208
msgid ""
"**[podman(1)](podman.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr ""
#: ../../source/markdown/podman-container-checkpoint.1.md:5
@@ -12338,7 +12338,7 @@ msgid ""
"systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, "
"**[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, "
"**[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**,"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" "
"**[systemd.unit(5)](https://www.freedesktop.org/software/systemd/man/systemd.unit.html)**,"
" **[setsebool(8)](https://man7.org/linux/man-"
@@ -14449,7 +14449,7 @@ msgid ""
"**[podman-save(1)](podman-save.1.md)**, **[podman-remote(1)](podman-"
"remote.1.md)**, **[podman-system-connection-add(1)](podman-system-"
"connection-add.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**,"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" **[containers-"
"transports(5)](https://github.com/containers/image/blob/main/docs"
"/containers-transports.5.md)**"
@@ -19758,7 +19758,7 @@ msgid ""
"/plugin-API.md) documentation in netavark. The binary must be placed in a"
" specified directory so podman can discover it, this list is set in "
"`netavark_plugin_dirs` in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" under the `[network]` section."
msgstr ""
@@ -20059,7 +20059,7 @@ msgid ""
"**[podman(1)](podman.1.md)**, **[podman-network(1)](podman-"
"network.1.md)**, **[podman-network-inspect(1)](podman-network-"
"inspect.1.md)**, **[podman-network-ls(1)](podman-network-ls.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr ""
#: ../../source/markdown/podman-network-create.1.md:200
@@ -20663,7 +20663,7 @@ msgid ""
"was added in Podman v4.0. CNI will be deprecated in the future in "
"preference of Netavark. To configure the network backend use the "
"`network_backend` key under the `[Network]` in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**."
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**."
" New systems use netavark by default, to check what backend is used run "
"`podman info --format {{.Host.NetworkBackend}}`."
msgstr ""
@@ -20774,7 +20774,7 @@ msgstr ""
msgid ""
"Podman requires specific default IPs and, thus, network subnets. The "
"default values used by Podman can be modified in the "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" file."
msgstr ""
@@ -20788,7 +20788,7 @@ msgid ""
"subnet. When Podman runs as root, the `podman` network is used as "
"default. It is the same as adding the option `--network bridge` or "
"`--network podman`. This subnet can be changed in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" under the [network] section. Set the `default_subnet` to any subnet that"
" is free in the environment. The name of the default network can also be "
"changed from `podman` to another name using the default network key. Note"
@@ -20804,7 +20804,7 @@ msgid ""
"When Podman is run as rootless, the internet connectivity is provided "
"with slirp4netns by default. Slirp4nents uses 10.0.2.0/24 for its default"
" network. This can also be changed in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" but under the `[engine]` section. Use the `network_cmd_options` key and "
"add `[\"cidr=X.X.X.X/24\"]` as a value. Note that slirp4netns needs a "
"network prefix size between 1 and 25. This option accepts an array, so "
@@ -20832,7 +20832,7 @@ msgid ""
" no subnet is given with the --subnet option, Podman starts picking a "
"free subnet from 10.89.0.0/24 to 10.255.255.0/24. Use the "
"`default_subnet_pools` option under the `[network]` section in "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" to change the range and/or size that is assigned by default."
msgstr ""
@@ -20840,7 +20840,7 @@ msgstr ""
msgid ""
"**[podman(1)](podman.1.md)**, **[podman-network-create(1)](podman-"
"network-create.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr ""
#: ../../source/markdown/podman-pause.1.md:5
@@ -24655,7 +24655,7 @@ msgstr ""
msgid ""
"**[podman(1)](podman.1.md)**, **[podman-system-service(1)](podman-system-"
"service.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr ""
#: ../../source/markdown/podman-rename.1.md:5
@@ -25676,7 +25676,7 @@ msgstr ""
#: ../../source/markdown/podman-save.1.md:115
msgid ""
"**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**,"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" **[containers-"
"transports(5)](https://github.com/containers/image/blob/main/docs"
"/containers-transports.5.md)**"
@@ -27160,7 +27160,7 @@ msgstr ""
msgid ""
"**[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**,"
" "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr ""
#: ../../source/markdown/podman-system-renumber.1.md:27
@@ -27407,7 +27407,7 @@ msgstr ""
msgid ""
"The default timeout can be changed via the `service_timeout=VALUE` field "
"in containers.conf. See "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" for more information."
msgstr ""
@@ -27451,7 +27451,7 @@ msgstr ""
msgid ""
"**[podman(1)](podman.1.md)**, **[podman-system-connection(1)](podman-"
"system-connection.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
msgstr ""
#: ../../source/markdown/podman-system-service.1.md:148
@@ -30255,7 +30255,7 @@ msgid ""
"Using a value other than **local** or **image**, Podman attempts to "
"create the volume using a volume plugin with the given name. Such plugins"
" must be defined in the **volume_plugins** section of the "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**"
" configuration file."
msgstr ""
@@ -30404,7 +30404,7 @@ msgstr ""
#: ../../source/markdown/podman-volume-create.1.md:115
msgid ""
"**[podman(1)](podman.1.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**,"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" **[podman-volume(1)](podman-volume.1.md)**, **mount(8)**, "
"**xfs_quota(8)**, **xfs_quota(8)**, **projects(5)**, **projid(5)**"
msgstr ""
@@ -32013,9 +32013,9 @@ msgstr ""
#: ../../source/markdown/podman.1.md:459
msgid ""
"**[containers-"
"mounts.conf(5)](https://github.com/containers/common/blob/main/docs"
"mounts.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs"
"/containers-mounts.conf.5.md)**, "
"**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**,"
"**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**,"
" **[containers-"
"registries.conf(5)](https://github.com/containers/image/blob/main/docs"
"/containers-registries.conf.5.md)**, **[containers-"

2
docs/source/markdown/options/network.md
View File

@@ -72,7 +72,7 @@ Valid _mode_ values are:
to disable automatic port forwarding based on bound ports. Similarly, **-T none**
and **-U none** are given to disable the same functionality from container to
host. \
All options can also be set in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**;
All options can also be set in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**;
see the `pasta_options` key under the network section in that file. \
Some examples:
- **pasta:--map-gw**: Allow the container to directly reach the host using the

4
docs/source/markdown/podman-attach.1.md.in
View File

@@ -10,7 +10,7 @@ podman\-attach - Attach to a running container
## DESCRIPTION
**podman attach** attaches to a running *container* using the *container's name* or *ID*, to either view its ongoing output or to control it interactively.\
The *container* can be detached from (and leave it running) using a configurable key sequence. The default sequence is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-keys** OPTION, or specifying it in the `containers.conf` file: see **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** for more information.
The *container* can be detached from (and leave it running) using a configurable key sequence. The default sequence is `ctrl-p,ctrl-q`. Configure the keys sequence using the **--detach-keys** OPTION, or specifying it in the `containers.conf` file: see **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** for more information.
## OPTIONS
@@option detach-keys
@@ -47,4 +47,4 @@ $ podman attach --no-stdin foobar
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[podman(1)](podman.1.md)**, **[podman-exec(1)](podman-exec.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**

4
docs/source/markdown/podman-build.1.md.in
View File

@@ -711,7 +711,7 @@ mechanism:
Exclude all doc files except Help.doc from the image.
This functionality is compatible with the handling of .containerignore files
described here: **[containerignore(5)](https://github.com/containers/common/blob/main/docs/containerignore.5.md)**
described here: **[containerignore(5)](https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md)**
### registries.conf (`/etc/containers/registries.conf`)
@@ -735,7 +735,7 @@ When using the `useradd` command within the build script, pass the
useradd to stop creating the lastlog file.
## SEE ALSO
**[podman(1)](podman.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[Containerfile(5)](https://github.com/containers/common/blob/main/docs/Containerfile.5.md)**, **[containerignore(5)](https://github.com/containers/common/blob/main/docs/containerignore.5.md)**
**[podman(1)](podman.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[Containerfile(5)](https://github.com/containers/container-libs/blob/main/common/docs/Containerfile.5.md)**, **[containerignore(5)](https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md)**
### Troubleshooting

2
docs/source/markdown/podman-compose.1.md.in
View File

@@ -20,4 +20,4 @@ By default, `podman compose` will emit a warning saying that it executes an exte
To see supported options of the installed compose provider, please run `podman compose --help`.
## SEE ALSO
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**

2
docs/source/markdown/podman-create.1.md.in
View File

@@ -543,7 +543,7 @@ page.
NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of downloaded container images. Podman defaults to use `/var/tmp`.
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-attach(1)](podman-attach.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **[podman-port(1)](podman-port.1.md)**, **[podman-start(1)](podman-start.1.md)**, **[podman-kill(1)](podman-kill.1.md)**, **[podman-stop(1)](podman-stop.1.md)**, **[podman-generate-systemd(1)](podman-generate-systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**, **[setsebool(8)](https://man7.org/linux/man-pages/man8/setsebool.8.html)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[fuse-overlayfs(1)](https://github.com/containers/fuse-overlayfs/blob/main/fuse-overlayfs.1.md)**, **proc(5)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **personality(2)**
**[podman(1)](podman.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-attach(1)](podman-attach.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **[podman-port(1)](podman-port.1.md)**, **[podman-start(1)](podman-start.1.md)**, **[podman-kill(1)](podman-kill.1.md)**, **[podman-stop(1)](podman-stop.1.md)**, **[podman-generate-systemd(1)](podman-generate-systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**, **[setsebool(8)](https://man7.org/linux/man-pages/man8/setsebool.8.html)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[fuse-overlayfs(1)](https://github.com/containers/fuse-overlayfs/blob/main/fuse-overlayfs.1.md)**, **proc(5)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **personality(2)**
### Troubleshooting

2
docs/source/markdown/podman-events.1.md
View File

@@ -221,7 +221,7 @@ $ podman events --format json
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
## HISTORY
March 2019, Originally compiled by Brent Baude <bbaude@redhat.com>

2
docs/source/markdown/podman-farm-build.1.md.in
View File

@@ -274,7 +274,7 @@ $ podman farm build --platforms arm64,amd64 -t name .
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-farm(1)](podman-farm.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, **[Containerfile(5)](https://github.com/containers/common/blob/main/docs/Containerfile.5.md)**, **[containerignore(5)](https://github.com/containers/common/blob/main/docs/containerignore.5.md)**
**[podman(1)](podman.1.md)**, **[podman-farm(1)](podman-farm.1.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[containers-certs.d(5)](https://github.com/containers/image/blob/main/docs/containers-certs.d.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[useradd(8)](https://www.unix.com/man-page/redhat/8/useradd)**, **[Containerfile(5)](https://github.com/containers/container-libs/blob/main/common/docs/Containerfile.5.md)**, **[containerignore(5)](https://github.com/containers/container-libs/blob/main/common/docs/containerignore.5.md)**
## HISTORY

2
docs/source/markdown/podman-image-scp.1.md
View File

@@ -96,7 +96,7 @@ Loaded image: docker.io/library/alpine:latest
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-remote(1)](podman-remote.1.md)**, **[podman-system-connection-add(1)](podman-system-connection-add.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**
**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-remote(1)](podman-remote.1.md)**, **[podman-system-connection-add(1)](podman-system-connection-add.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**
## HISTORY
July 2021, Originally written by Charlie Doern <cdoern@redhat.com>

4
docs/source/markdown/podman-network-create.1.md
View File

@@ -34,7 +34,7 @@ The netavark backend allows the use of so called *netavark plugins*, see the
[plugin-API.md](https://github.com/containers/netavark/blob/main/plugin-API.md)
documentation in netavark. The binary must be placed in a specified directory
so podman can discover it, this list is set in `netavark_plugin_dirs` in
**[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
under the `[network]` section.
The name of the plugin can then be used as driver to create a network for your plugin.
@@ -205,7 +205,7 @@ newnet
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-network(1)](podman-network.1.md)**, **[podman-network-inspect(1)](podman-network-inspect.1.md)**, **[podman-network-ls(1)](podman-network-ls.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[podman(1)](podman.1.md)**, **[podman-network(1)](podman-network.1.md)**, **[podman-network-inspect(1)](podman-network-inspect.1.md)**, **[podman-network-ls(1)](podman-network-ls.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
## HISTORY
August 2021, Updated with the new network format by Paul Holzinger <pholzing@redhat.com>

14
docs/source/markdown/podman-network.1.md
View File

@@ -27,21 +27,21 @@ Podman uses [Netavark](https://github.com/containers/netavark) as the network ba
| update | [podman-network-update(1)](podman-network-update.1.md) | Update an existing Podman network |
## SUBNET NOTES
Podman requires specific default IPs and, thus, network subnets. The default values used by Podman can be modified in the **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** file.
Podman requires specific default IPs and, thus, network subnets. The default values used by Podman can be modified in the **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** file.
### Podman network
The default bridge network (called `podman`) uses 10.88.0.0/16 as a subnet. When Podman runs as root, the `podman` network is used as default. It is the same as adding the option `--network bridge` or `--network podman`. This subnet can be changed in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** under the [network] section. Set the `default_subnet` to any subnet that is free in the environment. The name of the default network can also be changed from `podman` to another name using the default network key. Note that this is only done when no containers are running.
The default bridge network (called `podman`) uses 10.88.0.0/16 as a subnet. When Podman runs as root, the `podman` network is used as default. It is the same as adding the option `--network bridge` or `--network podman`. This subnet can be changed in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** under the [network] section. Set the `default_subnet` to any subnet that is free in the environment. The name of the default network can also be changed from `podman` to another name using the default network key. Note that this is only done when no containers are running.
### Pasta
Pasta by default performs no Network Address Translation (NAT) and copies the IPs from your main interface into the container namespace. If pasta cannot find an interface with the default route, it will select an interface if there is only one interface with a valid route. If you do not have a default route and several interfaces have defined routes, pasta will be unable to figure out the correct interface and it will fail to start. To specify the interface, use `-i` option to pasta. A default set of pasta options can be set in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** under the `[network]` section with the `pasta_options` key.
Pasta by default performs no Network Address Translation (NAT) and copies the IPs from your main interface into the container namespace. If pasta cannot find an interface with the default route, it will select an interface if there is only one interface with a valid route. If you do not have a default route and several interfaces have defined routes, pasta will be unable to figure out the correct interface and it will fail to start. To specify the interface, use `-i` option to pasta. A default set of pasta options can be set in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** under the `[network]` section with the `pasta_options` key.
The default rootless networking tool can be selected in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** under the `[network]` section with `default_rootless_network_cmd`, which can be set to `pasta` (default) or `slirp4netns`.
The default rootless networking tool can be selected in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** under the `[network]` section with `default_rootless_network_cmd`, which can be set to `pasta` (default) or `slirp4netns`.
### Slirp4netns
Slirp4netns uses 10.0.2.0/24 for its default network. This can also be changed in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** but under the `[engine]` section. Use the `network_cmd_options` key and add `["cidr=X.X.X.X/24"]` as a value. Note that slirp4netns needs a network prefix size between 1 and 25. This option accepts an array, so more options can be added in a comma-separated string as described on the **[podman-network-create(1)](podman-network-create.1.md)** man page. To change the CIDR for just one container, specify it on the cli using the `--network` option like this: `--network slirp4netns:cidr=192.168.1.0/24`.
Slirp4netns uses 10.0.2.0/24 for its default network. This can also be changed in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** but under the `[engine]` section. Use the `network_cmd_options` key and add `["cidr=X.X.X.X/24"]` as a value. Note that slirp4netns needs a network prefix size between 1 and 25. This option accepts an array, so more options can be added in a comma-separated string as described on the **[podman-network-create(1)](podman-network-create.1.md)** man page. To change the CIDR for just one container, specify it on the cli using the `--network` option like this: `--network slirp4netns:cidr=192.168.1.0/24`.
### Podman network create
When a new network is created with a `podman network create` command, and no subnet is given with the --subnet option, Podman starts picking a free subnet from 10.89.0.0/24 to 10.255.255.0/24. Use the `default_subnet_pools` option under the `[network]` section in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** to change the range and/or size that is assigned by default.
When a new network is created with a `podman network create` command, and no subnet is given with the --subnet option, Podman starts picking a free subnet from 10.89.0.0/24 to 10.255.255.0/24. Use the `default_subnet_pools` option under the `[network]` section in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** to change the range and/or size that is assigned by default.
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-network-create(1)](podman-network-create.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[podman(1)](podman.1.md)**, **[podman-network-create(1)](podman-network-create.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**

2
docs/source/markdown/podman-remote.1.md
View File

@@ -193,7 +193,7 @@ Users can modify defaults by creating the `$HOME/.config/containers/containers.c
Podman uses builtin defaults if no containers.conf file is found.
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-system-service(1)](podman-system-service.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[podman(1)](podman.1.md)**, **[podman-system-service(1)](podman-system-service.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
### Troubleshooting

2
docs/source/markdown/podman-run.1.md.in
View File

@@ -990,7 +990,7 @@ page.
NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of downloaded container images. Podman defaults to use `/var/tmp`.
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-attach(1)](podman-attach.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **[podman-port(1)](podman-port.1.md)**, **[podman-start(1)](podman-start.1.md)**, **[podman-kill(1)](podman-kill.1.md)**, **[podman-stop(1)](podman-stop.1.md)**, **[podman-generate-systemd(1)](podman-generate-systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**, **[setsebool(8)](https://man7.org/linux/man-pages/man8/setsebool.8.html)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[fuse-overlayfs(1)](https://github.com/containers/fuse-overlayfs/blob/main/fuse-overlayfs.1.md)**, **proc(5)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **personality(2)**
**[podman(1)](podman.1.md)**, **[podman-save(1)](podman-save.1.md)**, **[podman-ps(1)](podman-ps.1.md)**, **[podman-attach(1)](podman-attach.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **[podman-port(1)](podman-port.1.md)**, **[podman-start(1)](podman-start.1.md)**, **[podman-kill(1)](podman-kill.1.md)**, **[podman-stop(1)](podman-stop.1.md)**, **[podman-generate-systemd(1)](podman-generate-systemd.1.md)**, **[podman-rm(1)](podman-rm.1.md)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**, **[setsebool(8)](https://man7.org/linux/man-pages/man8/setsebool.8.html)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[fuse-overlayfs(1)](https://github.com/containers/fuse-overlayfs/blob/main/fuse-overlayfs.1.md)**, **proc(5)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **personality(2)**
### Troubleshooting

2
docs/source/markdown/podman-save.1.md.in
View File

@@ -84,7 +84,7 @@ Storing signatures
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**
**[podman(1)](podman.1.md)**, **[podman-load(1)](podman-load.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**
## HISTORY
July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>

2
docs/source/markdown/podman-system-renumber.1.md
View File

@@ -27,7 +27,7 @@ $ podman system renumber
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
## HISTORY
February 2019, Originally compiled by Matt Heon (mheon at redhat dot com)

4
docs/source/markdown/podman-system-service.1.md
View File

@@ -105,7 +105,7 @@ Connections that present no certificate or a certificate not signed by one of th
Path to a PEM file containing the private key matching `--tls-cert`. `--tls-cert` must also be provided.
The default timeout can be changed via the `service_timeout=VALUE` field in containers.conf.
See **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** for more information.
See **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** for more information.
## EXAMPLES
@@ -155,7 +155,7 @@ podman system service --time 0 unix:///var/run/mypodman.sock
This starts the API service listening on the custom socket `/var/run/mypodman.sock` with no inactivity timeout (runs indefinitely).
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-system-connection(1)](podman-system-connection.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**
**[podman(1)](podman.1.md)**, **[podman-system-connection(1)](podman-system-connection.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**
## HISTORY
January 2020, Originally compiled by Brent Baude `<bbaude@redhat.com>`

4
docs/source/markdown/podman-volume-create.1.md
View File

@@ -26,7 +26,7 @@ The **image** driver uses an image as the backing store of for the volume.
An overlay filesystem is created, which allows changes to the volume to be committed as a new layer on top of the image.
Using a value other than **local** or **image**, Podman attempts to create the volume using a volume plugin with the given name.
Such plugins must be defined in the **volume_plugins** section of the **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** configuration file.
Such plugins must be defined in the **volume_plugins** section of the **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** configuration file.
#### **--gid**=*gid*
@@ -214,7 +214,7 @@ If performance is the priority, please check out the more performant [goofys](ht
## SEE ALSO
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[podman-volume(1)](podman-volume.1.md)**, **mount(8)**, **xfs_quota(8)**, **xfs_quota(8)**, **projects(5)**, **projid(5)**
**[podman(1)](podman.1.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[podman-volume(1)](podman-volume.1.md)**, **mount(8)**, **xfs_quota(8)**, **xfs_quota(8)**, **projects(5)**, **projid(5)**
## HISTORY
January 2020, updated with information on volume plugins by Matthew Heon <mheon@redhat.com>

2
docs/source/markdown/podman.1.md
View File

@@ -487,7 +487,7 @@ The Overlay file system (OverlayFS) is not supported with kernels prior to 5.12.
The Network File System (NFS) and other distributed file systems (for example: Lustre, Spectrum Scale, the General Parallel File System (GPFS)) are not supported when running in rootless mode as these file systems do not understand user namespace. However, rootless Podman can make use of an NFS Homedir by modifying the `$HOME/.config/containers/storage.conf` to have the `graphroot` option point to a directory stored on local (Non NFS) storage.
## SEE ALSO
**[containers-mounts.conf(5)](https://github.com/containers/common/blob/main/docs/containers-mounts.conf.5.md)**, **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[containers-storage.conf(5)](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[oci-hooks(5)](https://github.com/containers/common/blob/main/pkg/hooks/docs/oci-hooks.5.md)**, **[containers-policy.json(5)](https://github.com/containers/image/blob/main/docs/containers-policy.json.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **[podman-quadlet(1)](podman-quadlet.1.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**
**[containers-mounts.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers-mounts.conf.5.md)**, **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)**, **[containers-registries.conf(5)](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md)**, **[containers-storage.conf(5)](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md)**, **[buildah(1)](https://github.com/containers/buildah/blob/main/docs/buildah.1.md)**, **[oci-hooks(5)](https://github.com/containers/container-libs/blob/main/common/pkg/hooks/docs/oci-hooks.5.md)**, **[containers-policy.json(5)](https://github.com/containers/image/blob/main/docs/containers-policy.json.5.md)**, **[crun(1)](https://github.com/containers/crun/blob/main/crun.1.md)**, **[runc(8)](https://github.com/opencontainers/runc/blob/main/man/runc.8.md)**, **[subuid(5)](https://www.unix.com/man-page/linux/5/subuid)**, **[subgid(5)](https://www.unix.com/man-page/linux/5/subgid)**, **[slirp4netns(1)](https://github.com/rootless-containers/slirp4netns/blob/master/slirp4netns.1.md)**, **[pasta(1)](https://passt.top/builds/latest/web/passt.1.html)**, **[conmon(8)](https://github.com/containers/conmon/blob/main/docs/conmon.8.md)**, **[podman-quadlet(1)](podman-quadlet.1.md)**, **[podman-systemd.unit(5)](podman-systemd.unit.5.md)**
### Troubleshooting

4
docs/tutorials/rootless_tutorial.md
View File

@@ -31,7 +31,7 @@ The major user-facing difference between the two is outlined in [this blog post]
> [!note]
> pasta's default situation of not being able to communicate between the container and the host has been fixed in Podman 5.3: see [Podman 5.3 changes for improved networking experience with pasta](https://blog.podman.io/2024/10/podman-5-3-changes-for-improved-networking-experience-with-pasta/).
The default rootless networking tool can be selected in **[containers.conf(5)](https://github.com/containers/common/blob/main/docs/containers.conf.5.md)** under the `[network]` section with `default_rootless_network_cmd`, which can be set to `pasta` (default) or `slirp4netns`.
The default rootless networking tool can be selected in **[containers.conf(5)](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md)** under the `[network]` section with `default_rootless_network_cmd`, which can be set to `pasta` (default) or `slirp4netns`.
### `/etc/subuid` and `/etc/subgid` configuration
@@ -125,7 +125,7 @@ Note: in environments without `XDG` environment variables, Podman internally set
- `/run/user/$UID` on `systemd` environments
- `$TMPDIR/podman-run-$UID` otherwise
The three main configuration files are [containers.conf](https://github.com/containers/common/blob/main/docs/containers.conf.5.md), [storage.conf](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md) and [registries.conf](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md). The user can modify these files as they wish.
The three main configuration files are [containers.conf](https://github.com/containers/container-libs/blob/main/common/docs/containers.conf.5.md), [storage.conf](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md) and [registries.conf](https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md). The user can modify these files as they wish.
#### containers.conf
Podman reads

2
troubleshooting.md
View File

@@ -1406,7 +1406,7 @@ Executing a step in a `Dockerfile`/`Containerfile` which mounts secrets using `-
#### Symptom
A `RUN` line in the `Dockerfile`/`Containerfile` contains a [secret mount](https://github.com/containers/common/blob/main/docs/Containerfile.5.md) such as `--mount=type=secret,id=MY_USER,target=/etc/dnf/vars/MY_USER`.
A `RUN` line in the `Dockerfile`/`Containerfile` contains a [secret mount](https://github.com/containers/container-libs/blob/main/common/docs/Containerfile.5.md) such as `--mount=type=secret,id=MY_USER,target=/etc/dnf/vars/MY_USER`.
When running `podman build` the process fails with an error message like:
```