installer: Could not pull cloudron/base error – Suggested fix

Where necessary, you may need to have access to a VPS server so you can follow how to implement the steps in this article.  You can get a cheaper VPS Server from Contabo with 4vCPU cores, 8GM RAM, and 32TB Bandwidth for less than $5.50 per month. Get this deal here now

Table of Contents

Cloud VPS S

$5.50 Monthly
  • 4 vCPU Cores | 8GB RAM


$15.50 Monthly
  • 6 vCPU Cores | 16GB RAM


$17.50 Monthly
  • 8 vCPU Cores | 24GB RAM

In some cases, when you’re trying to install Cloudron on a VPS server, you can experience this error: installer: Could not pull cloudron/base. So, what is the most likely cause of this error?

First of all, you need to understand that when a user deploys an application on Cloudron, the platform downloads the corresponding Docker image and creates a container from it. Cloudron then configures the container to run the application and exposes it to the internet using a reverse proxy. This allows users to access the application from a custom domain or subdomain.

Cloudron itself is not installed as a Docker image, but it uses Docker containers to package and deploy web applications. When you install Cloudron on a server, it sets up a Docker-based infrastructure that includes a reverse proxy, a database server, a mail server, and other components needed to run web applications.

So, Cloudron on your server has to connect to a Docker registry to download the necessary Docker images for running various web applications. This is necessary because Cloudron is designed to work with a curated set of open-source web applications, which are packaged as Docker images and hosted on a Docker registry.

RECOMMENDED READING: How to deploy WordPress on a Ubuntu LAMP Server

The Docker registry is a repository for storing and distributing Docker images. The images contain everything needed to run an application, including the application code, dependencies, and configuration settings. By downloading Docker images from a registry, Cloudron can ensure that the applications it installs are secure, up-to-date, and well-maintained.

To emphasize it for you, Cloudron has to establish a successful connection to the Docker registry to keep track of updates to the applications it installs. When a new version of an application is released, Cloudron can automatically download the updated Docker image and install it on the server. This makes it easy to keep your applications up-to-date and secure.

RECOMMENDED READING: How can I fix Cloudron domain redirection issues?

So, the error: installer: Could not pull cloudron/base error is likely to be because your server is not able to establish the necessary connection to the docker registry endpoints. A Docker registry endpoint is the URL or hostname that is used to access the Docker registry.

No IPv6 attached to your Server

In 2021, the Docker Developer team announced that the Docker registry would start supporting IPv6 pull and push requests.

In some cases, Cloudron can try to establish a connection to an IPv6 docker registry endpoint, But your VPS server may lack support for IPv6-related connections.

Now, try running the following command to check if your server succeeds in establishing a connection request to the Docker registry endpoint, registry.ipv6.docker.con,

curl -v

You’re most likely to see something like this below in the screenshot if your server doesn’t have support for IPv6 connections

CREDIT: Screenshot by chaitanya

You will notice that when your server does not have Ipv6 enabled, connection requests won’t go through. But thing is, Cloudron may want to use IPv6 for its Docker-related background activities on your server.

To fix this issue, you need to enable or configure IPv6 on your server, and this will depend on the VPS provider you’re using. Various VPS providers like Contabo offer support for IPv6 connections. But if you can’t figure out it, you will need to contact your VPS provider to help you enable this feature on your server.

RECOMMENDED READING: How to fix Server crashes when running “composer update”

Other possible fixes for this error

If the above fix doesn’t work, You can also try to explore the following to suggestions to see if they can work for you:

  • Check your network connectivity: Ensure that your server has a stable internet connection and is not behind a firewall that may be blocking the required ports.

  • Check the availability of the base image: Check whether the Cloudron base image is available on the Docker Hub repository. If it is not available, you may need to contact the Cloudron support team for assistance.
  • Contact Cloudron support: If it continues to behave the same way, you can use the Cloudron community forum or contact the Cloudron support team to help in resolving this issue.

RECOMMENDED READING: How to deploy WordPress on a Ubuntu LAMP Server

Hire us to handle what you want

Hire us through our Fiverr Profile and leave all the complicated & technical stuff to us. Here are some of the things we can do for you:

  • Website migration, troubleshooting, and maintenance.
  • Server & application deployment, scaling, troubleshooting, and maintenance
  • Deployment of Kubernetes, Docker, Cloudron, Ant Media, Apache, Nginx,  OpenVPN, cPanel, WHMCS, WordPress, and more
  • Everything you need on AWS, IBM Cloud, GCP, Azure, Oracle Cloud, Alibaba Cloud, Linode, Contabo, DigitalOcean, Ionos, Vultr, GoDaddy, HostGator, Namecheap, DreamHost, and more.

We will design, configure, deploy, or troubleshoot anything you want. Starting from $10, we will get your job done in the shortest time possible. Your payment is safe with Fiverr as we will only be paid once your project is completed.