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, registry.ipv6.docker.com/v2
. 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 https://registry.ipv6.docker.com/
You’re most likely to see something like this below in the screenshot if your server doesn’t have support for IPv6 connections
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