Commit graph

108 commits

Author SHA1 Message Date
Byounguk Lee
5cd4dc4225 docs: redirect version check to latest GitHub release page
The bug reporting instructions previously asked users to compare
their Podman version with the one documented at the top of the README.

This commit updates the issue templates and troubleshooting guide to
point users directly to the latest GitHub release page instead.
Additionally, the obsolete .github/ISSUE_TEMPLATE.md file is removed.

Fixes: #28818

Signed-off-by: Byounguk Lee <nimdrak@gmail.com>
2026-06-03 11:07:10 +00:00
Paul Holzinger
04c53e07bf
Merge pull request #28666 from eriksjolund/add-troubleshooting-tips
Add troubleshooting tips
2026-05-11 12:39:27 +02:00
Erik Sjölund
33db50ab24
troubleshooting: document setgroups requirement
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2026-05-11 07:56:57 +02:00
Erik Sjölund
d9836ac255
troubleshooting: add tip about is transient
Add tip:

50) `systemctl enable` fails with `Failed to enable unit: Unit` ... `is transient or generated`

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2026-05-09 13:33:37 +02:00
Erik Sjölund
6cc0439b8f
troubleshooting: add tip about could not connect
Add tip:

49) Can't connect to host's main network interface

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2026-05-09 13:31:43 +02:00
Erik Sjölund
a3ea76b6a3
troubleshooting: add tip about bind permission denied
Add tip:

48) Pasta fails with `Listen failed` or rootless podman fails with `bind: permission denied`

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2026-05-09 13:31:29 +02:00
Erik Sjölund
ec6415f7c6
troubleshooting: add tip about Connection reset by peer
Add tip:

47) Connecting to published port fails with `Connection reset by peer`

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2026-05-09 13:31:12 +02:00
Erik Sjölund
644104a8b5
troubleshooting: add tip about pod uid/gid map
Add tip:

46) Creating container fails with
    `Error: cannot specify a new uid/gid map when entering
    a pod with an infra container: invalid argument`

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2026-05-09 13:29:40 +02:00
Erik Sjölund
8a064651e8
troubleshooting: document keep-id size option
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2026-05-01 16:45:53 +02:00
Lokesh Mandvekar
9837656d26
docs: remove rootless CNI troubleshooting section
Signed-off-by: Lokesh Mandvekar <lsm5@redhat.com>
2026-03-19 20:26:22 +05:30
Lewis Roy
fc18d3229d [DOCS] Update references common -> container-libs/common
Signed-off-by: Lewis Roy <lewisdenny@me.com>
2026-02-04 21:29:17 +10:00
Erik Sjölund
796be1e4bf
troubleshooting: document lsetxattr error
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2025-09-10 20:32:34 +02:00
Erik Sjölund
7fbc6d9370 troubleshooting: adjust home path in tip 44
Modify the home dir path in troubleshooting tip 44
to prevent files from being accidentally removed.

userdel with force argument tries to remove home dir path "/"
according to
https://github.com/shadow-maint/shadow/issues/1050

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2024-09-25 08:10:57 +02:00
Erik Sjölund
9a8e17816a troubleshooting: add tip about the user containers
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2024-09-16 08:18:21 +02:00
Erik Sjölund
005d9b543b troubleshooting: add tip about auto, keep-id, nomap
Add tip about --userns=auto, --userns=keep-id,
--userns=nomap and the error message:
"not enough unused IDs in user namespace"

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2024-09-07 09:50:35 +02:00
Jared Sprague
26cefcbf98 Added an additional troubleshooting problem and solution
Signed-off-by: Jared Sprague <jared@caramelcode.com>
2023-08-29 09:41:38 -04:00
Philipp Wagner
0ecc0d9e10 Document how to get secret mounts working on RHEL8
Add a section to the troubleshooting guide describing how to get secret
mounts working in an environment with nosuid-mounted file systems and
runc, such as RHEL8, as discussed in
https://github.com/containers/buildah/issues/4228.

Signed-off-by: Philipp Wagner <phw@ibm.com>
2023-06-14 09:34:21 +02:00
fatelei
81d64547f1 feat: add insecure registry troubleshooting solution
Signed-off-by: fatelei <fatelei@gmail.com>
2023-06-02 14:50:13 +08:00
Erik Sjölund
685c736185 source code comments and docs: fix typos, language, Markdown layout
- fix a/an before noun
- fix loose -> lose
- fix "the the"
- fix lets -> let's
- fix Markdown layout
- fix a few typos
- remove unnecessary text in troubleshooting.md

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2023-05-22 07:52:16 +02:00
Erik Sjölund
24be46a517 [CI:DOCS] troubleshooting: fix subuid example
Fix incorrect number of required subuids in subuid example.

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

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2023-05-01 16:03:04 +02:00
tomsweeneyredhat
25dd4d653e [CI:DOCS] Add image not found info to troubleshooting
Addresses: https://bugzilla.redhat.com/show_bug.cgi?id=2139191

We have a timing issue when doing a build or pull of an image and
a second process is removing them at the same time.  This is not
a window we're going to close now, so I'm adding a note to the
troubleshooting guide to document it.

[NO NEW TESTS NEEDED]
Signed-off-by: tomsweeneyredhat <tsweeney@redhat.com>
2023-03-03 11:22:57 -05:00
Erik Sjölund
72966a32cd [CI:DOCS] Fix spelling and typos
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-11-19 16:26:00 +01:00
Erik Sjölund
6ec2bcb689 [CI:DOCS] troubleshooting: document keep-id options
Add new troubleshooting tip:
Podman run fails with "Error: unrecognized namespace mode keep-id:uid=1000,gid=1000 passed"

Update the troubleshooting tips:
"Passed-in devices or files can't be accessed in rootless container (UID/GID mapping problem)"
and
"Container creates a file that is not owned by the user's regular UID"
to use
"--userns keep-id:uid=$uid,gid=$gid"
instead of the command-line options --uidmap and --gidmap

Co-authored-by: Tom Sweeney <tsweeney@redhat.com>
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-11-02 22:18:29 +01:00
Daniel J Walsh
2c63b8439b
Fix stutters
Podman adds an Error: to every error message.  So starting an error
message with "error" ends up being reported to the user as

Error: error ...

This patch removes the stutter.

Also ioutil.ReadFile errors report the Path, so wrapping the err message
with the path causes a stutter.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2022-09-10 07:52:00 -04:00
Toshiki Sonoda
0f768cef3b [CI:DOCS] Update Troubleshooting.md
- Fix the item number
- Fix the links

Signed-off-by: Toshiki Sonoda <sonoda.toshiki@fujitsu.com>
2022-08-23 08:47:02 +09:00
Toshiki Sonoda
f8e73eadd2 [CI:DOCS] Update how to enable resource limit delegation
Add a information about `cpu-shares` option and `CPUSET` limits.

Signed-off-by: Toshiki Sonoda <sonoda.toshiki@fujitsu.com>
2022-08-22 21:07:42 +09:00
unknowndevQwQ
f4c53a41cf docs: update the podman logo
for podman/#15222

Signed-off-by: unknowndevQwQ <unknowndevQwQ@pm.me>
2022-08-07 09:11:53 +08:00
openshift-ci[bot]
914835d3e4
Merge pull request #14813 from eriksjolund/add_troubleshooting_tip_about_carriage_return
[CI:DOCS] troubleshooting: document --tty and CR
2022-07-05 11:07:31 +00:00
Erik Sjölund
5491123c2c [CI:DOCS] troubleshooting: document --tty and CR
* Add troubleshooting tip
  "Unexpected carriage returns are outputted on the terminal"

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-07-03 08:55:29 +02:00
Erik Sjölund
24fcfb5d9e Fix spelling "read only" -> "read-only"
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-07-02 08:37:43 +02:00
Erik Sjölund
aa4279ae15 Fix spelling "setup" -> "set up" and similar
* Replace "setup", "lookup", "cleanup", "backup" with
  "set up", "look up", "clean up", "back up"
  when used as verbs. Replace also variations of those.

* Improve language in a few places.

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-06-22 18:39:21 +02:00
tomsweeneyredhat
3a32d60e5b [CI:DOCS] Quick typo for troubleshooting
After lgtming the latest from @flouthouc, I spotted one
more minor typo in the troubleshooting guide.  This corrects it.

Signed-off-by: tomsweeneyredhat <tsweeney@redhat.com>
2022-05-26 16:15:07 -04:00
Aditya R
ab0728421b
docs: note regarding version compatablity between server and client for bug fixes
Add a small note to troubleshooting docs regaring version parity between
podman-client and podman-server when looking for bug fixes.

[NO TESTS NEEDED]
[NO NEW TESTS NEEDED]

Closes: https://github.com/containers/podman/issues/12660

Signed-off-by: Aditya R <arajan@redhat.com>
2022-05-26 23:24:18 +05:30
bwduncan
b03466cb79 Update troubleshooting.md
- Consistent code block highlighting
- Minor spelling, formatting.

Signed-off-by: Bruce Duncan <bwduncan@gmail.com>
2022-04-15 12:02:39 +01:00
Abhijeet Kasurde
4f73cf3fc7 Misc typo fixes
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2022-03-25 16:22:42 +05:30
Giuseppe Scrivano
07999b2373
[CI:DOCS] troubleshooting: document rm in image stores
Closes: https://github.com/containers/podman/issues/13003

[NO NEW TESTS NEEDED]

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2022-03-22 13:14:17 +01:00
Erik Sjölund
db30102793 [CI:DOCS] troubleshooting.md: mention "podman unshare chown 0:0 path"
* Mention the command "podman unshare chown 0:0 dir1/a"
  that changes file ownership to the regular user's UID and GID on
  the host.

Co-authored-by: Tom Sweeney <tsweeney@redhat.com>
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-03-09 08:55:36 +01:00
Erik Sjölund
b209933930 [CI:DOCS] troubleshooting.md: Improve language and fix typos
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-03-05 18:06:36 +01:00
OpenShift Merge Robot
d3699bbce6
Merge pull request #13231 from eriksjolund/troubleshooting_mention_systemd-run_and_machinectl
[CI:DOCS] troubleshooting: mention machinectl and systemd-run
2022-02-23 10:29:12 -05:00
OpenShift Merge Robot
ad47fa2d67
Merge pull request #13305 from nalind/troubleshooting
[CI:DOCS] troubleshooting.md: tweak subuid paragraph, encryption
2022-02-21 12:19:42 -05:00
Nalin Dahyabhai
f150f29211 troubleshooting.md: tweak subuid paragraph, encryption
Expand the bit about needing to allocate UIDs so that we don't appear to
imply that adding a range of 10000 IDs to /etc/subuid will allow people
to use UID 1000000, which isn't in the range that we'd map a range of
that size to.

TLS is an acronym, so capitalize when we're talking about the protocol.

TLS verification is about encryption, not authentication.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>
2022-02-21 10:23:50 -05:00
Erik Sjölund
d12489858d [CI:DOCS] troubleshooting: mention overlay option for --rootfs
* Mention overlay option for --rootfs. Overlay description text
  is from commit 020d81f113
  by Qi Wang

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-02-18 08:04:30 +01:00
Erik Sjölund
8c9d37fafc [CI:DOCS] troubleshooting: mention machinectl and systemd-run
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-02-18 07:01:32 +01:00
Erik Sjölund
3b5a3f4a74 [CI:DOCS] Add --userns=keep-id, --uidmap, --gidmap troubleshooting
* Add troubleshooting advice: "Container creates a file that is
  not owned by the user's regular UID". The solution involves
  using the options --uidmap and --gidmap.

* Add troubleshooting advice: "Passed-in devices or files can't be
  accessed in rootless container (UID/GID mapping problem)".
  The general solution involves using the options --uidmap and
  --gidmap. Sometimes --userns=keep-id could be used.

Co-authored-by: Tom Sweeney <tsweeney@redhat.com>

Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2022-02-12 07:29:09 +01:00
Giuseppe Scrivano
a0b38c071b
troubleshooting: add doc for ssh into a container
Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
2022-02-10 17:08:54 +01:00
bazhang87
86547cc24a
Update troubleshooting.md
Signed-off-by: Bart Zhang bazhang@redhat.com
Co-authored-by: Erik Sjölund <erik.sjolund@gmail.com>
Co-authored-by: Tom Sweeney <tsweeney@redhat.com>
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2022-01-27 07:45:11 -05:00
Daniel J Walsh
5736649eb8
Run codespell on code
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2022-01-21 09:52:12 -05:00
Valentin Rothberg
9a10e2124b systemd: replace multi-user with default.target
Replace `multi-user.target` with `default.target` across the code base.
It seems like the multi-user one is not available for (rootless) users
on F35 anymore is causing issues in all kinds of ways, for instance,
enabling the podman.service or generated systemd units.

Fixes: #12438
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
2021-11-30 14:37:25 +01:00
Erik Sjölund
936ab158c6
[CI:DOCS] Fix typo keep_id -> keep-id
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
2021-10-24 09:54:23 +03:00
Daniel J Walsh
7112a4159b
Fix codespell errors
Along with a couple of nits found by Ed.

[NO NEW TESTS NEEDED]

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2021-10-14 08:44:09 -04:00