---
title: "How to pull from images from docker.io with podman"
description: "!https://gist.github.com/isomorphisms/3114ab86960656a729a6b4653001aae2"
date: 2023-07-28
published: true
tags:
  - containers
  - docker
  - linux
  - podman
  - thought
template: link
---


<div class="embed-card embed-card-external embed-card-provider-github" data-needs-code-css="true">
  <div class="embed-card-rich">
<div data-needs-code-css="true"><div class="embed-gist">
  <div class="embed-gist-header">
    <a href="https://gist.github.com/isomorphisms/3114ab86960656a729a6b4653001aae2" target="_blank" rel="noopener noreferrer">gistfile1.txt</a>
    <span class="embed-gist-language">text</span>
  </div>
<pre class="chroma"><code><span class="line"><span class="cl">On void linux.
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">Under `/etc/containers/` there is a file called `registries.conf`. It is complemented by `man 5 containers-registries.conf`.
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">Change (for me lines 11-12) which say
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">[registries.search]
</span></span><span class="line"><span class="cl">registries = []
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">to
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">
</span></span></code></pre><p>[registries.search]
registries = ['docker.io']</p>
<pre><code>
(drawn from https://www.projectatomic.io/blog/2018/05/podman-tls/)




---------------


Without the above you won't be able to use basic `podman` functions. You might get errors like:

- `Error: unable to pull fedora:28: image name provided is a short name and no search registries are defined in the registries config file.`
- `Error: unable to pull stripe/stripe-cli: image name provided is a short name and no search registries are defined in the registries config file.`




--------


Various documentation (redhat blog entries, `man podman` pages) say that dockerhub is a default, but without this step it's clearly not.


Good luck. Feel free to use the comment box below if you have a github account.
</code></pre>

</div>
</div>
  </div>
</div>


By default podman will not pull images from docker.io and will need setup.  This guide worked for me.