Cannot install anything from AppStore

Insight & Feedback
, ,
1

I have installed the OS, but i cannot install anything from the app store. when i try, the installation stays at 5% and i get the following error:

“Failed to pull image after trying 4 different mirror methods. If this is a private image, verify registry credentials and pull permissions”

Is there any fix for this?

2

Yeah this one’s pretty common, and it’s usually not the app itself, it’s the system struggling to pull Docker images.

That error basically means ZimaOS tried multiple mirrors and couldn’t download the image at all.

A few things to check (keep it simple):

  • First, network/DNS, this is the biggest one
    If DNS is slow or blocked, pulls just hang around 5% then fail
    Try switching your router DNS to something solid like Google (8.8.8.8) or Cloudflare (1.1.1.1)
  • Try a quick sanity check
    Open Terminal and pull something manually:
docker pull hello-world

If that fails > it’s definitely network / DNS / firewall, not the App Store

  • Check time/date on the system
    If it’s off, TLS can fail silently during image pulls
  • If you’re behind strict firewall / ISP filtering
    Some registries or mirrors can get blocked > same symptom

Also worth noting, ZimaOS App Store is just Docker under the hood, so if Docker can’t pull, nothing in the App Store will install.

If that docker pull hello-world works fine, then we look deeper. If it fails, you’ve already found the root cause.

3

I’ve NEVER had any success pulling apps from the App Store. I have always had to do a custom install for some reason. And even then sometimes I still run into issues. I’m struggling right now because I can’t get Spoolman installed via the app store or those a custom install. I figured maybe it was time to download portainer since I’m not good at this and I can’t get that to install either. To be clear, they download just fine but when I go to their port they never actually start up. Any ideas?

4

That actually sounds different to the original issue.

If the images are downloading fine but nothing loads on the port, then the problem isn’t the App Store, it’s that the containers aren’t starting properly or aren’t binding to the port.

First thing I’d check is whether the containers are even running:

docker ps -a

Look at the STATUS column

  • “Exited” or restarting > something inside the container is failing
  • “Up” but no access > likely port or network issue

Then check logs for one of the apps that won’t start:

docker logs <container_name>

That will usually tell you exactly why it’s failing.

Couple of common causes on ZimaOS:

  • Port already in use by another container
  • Volume path permissions under /DATA/AppData
  • App expects config/env vars that weren’t set in the App Store template
  • Container starts but binds to localhost only (so you can’t access it externally)

Also worth checking what ports are actually exposed:

docker ps

Make sure you see something like 0.0.0.0:PORT-> inside the PORTS column.

Right now I wouldn’t reinstall anything yet, you’ll just hit the same issue again. The logs will point straight to the cause.