summaryrefslogtreecommitdiff
path: root/troubleshooting.md
diff options
context:
space:
mode:
authorTomSweeneyRedHat <tsweeney@redhat.com>2018-09-13 11:49:19 -0400
committerAtomic Bot <atomic-devel@projectatomic.io>2018-09-13 18:31:21 +0000
commitf0a3a4329ecaaadd60331641712d5e9b35e1120f (patch)
treefaa8f15f95c7ed60cda97b4751dda599e4ffeba6 /troubleshooting.md
parent8e65b294c60997b9e394a5e3543673dbebf8fe93 (diff)
downloadpodman-f0a3a4329ecaaadd60331641712d5e9b35e1120f.tar.gz
podman-f0a3a4329ecaaadd60331641712d5e9b35e1120f.tar.bz2
podman-f0a3a4329ecaaadd60331641712d5e9b35e1120f.zip
Add notes to check version on problem
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com> Closes: #1462 Approved by: rhatdan
Diffstat (limited to 'troubleshooting.md')
-rw-r--r--troubleshooting.md15
1 files changed, 13 insertions, 2 deletions
diff --git a/troubleshooting.md b/troubleshooting.md
index d0d84f7cc..db36d1bb8 100644
--- a/troubleshooting.md
+++ b/troubleshooting.md
@@ -5,7 +5,18 @@
## A list of common issues and solutions for Podman
---
-### 1) No such image or Bare keys cannot contain ':'
+### 1) Variety of issues - Validate Version
+
+A large number of issues reported against Podman are often found to already be fixed
+in more current versions of the project. Before reporting an issue, please verify the
+version you are running with `podman version` and compare it to the lastest release
+documented on the top of Podman's [README.md](README.md).
+
+If they differ, please update your version of PODMAN to the latest possible
+and retry your command before reporting the issue.
+
+---
+### 2) No such image or Bare keys cannot contain ':'
When doing a `podman pull` or `podman build` command and a "common" image can not be pulled,
it is likely that the `/etc/containers/registries.conf` file is either not installed or possibly
@@ -33,7 +44,7 @@ error pulling image "fedora": unable to pull fedora: error getting default regis
* i.e. `registries = ['registry.fedoraproject.org', 'quay.io', 'registry.access.redhat.com']`
---
-### 2) http: server gave HTTP response to HTTPS client
+### 3) http: server gave HTTP response to HTTPS client
When doing a Podman command such as `build`, `commit`, `pull`, or `push` to a registry,
tls verification is turned on by default. If authentication is not used with