---
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:
  - docker
  - podman
  - linux
  - 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.

!!! note

    This post is a <a href="/thoughts/" class="wikilink" data-title="Thoughts" data-description="These are generally my thoughts on a web page or some sort of url, except a rare few don&#39;t have a link. These are dual published off of my..." data-date="2024-04-01">thought</a>. It's a short note that I make
    about someone else's content online <a href="/tags/thoughts/" class="hashtag-tag" data-tag="thoughts" data-count=2 data-reading-time=3 data-reading-time-text="3 minutes">#thoughts</a>