GoAdmio

docker

Install Docker CE, containerd, and Docker Compose on RHEL-family servers

On this page: Overview · Quick start · Syntax · Options · Output · Examples · Troubleshooting · Details · See also


Overview

/go/docker installs Docker on the server in one command. It:

The call is appended to /var/log/go/docker.log.


Quick start

/go/docker

Syntax

/go/docker

The command takes no arguments. Anything you pass is only written to the log.

It uses dnf and Docker's CentOS repository, so it works on RHEL-family systems such as AlmaLinux, Rocky Linux, CentOS, and Red Hat. It does not check the operating system first; on a Debian or Ubuntu server it fails at the first dnf call.


Options

None.


Output

The command prints Installing Docker..., then the output of dnf and curl. It prints no summary and no version numbers. Check the result yourself:

docker --version
docker-compose --version
systemctl status docker

Examples

# Install Docker and Compose
/go/docker

# Check that the service is running
systemctl status docker

# Run a test container
docker run --rm hello-world

Troubleshooting

Symptom Likely cause Fix
dnf: command not found The server runs Debian or Ubuntu. Install Docker with apt by following Docker's own instructions.
No such command: config-manager dnf-plugins-core isn't installed. Run dnf -y install dnf-plugins-core, then run the command again.
Repository or package errors The server can't reach download.docker.com, or the OS isn't compatible with the CentOS repository. Check outbound access and the OS version.
docker-compose: command not found The Compose download failed. Check access to github.com, then run the command again.
docker-compose prints a syntax error A failed download left an error page in /usr/local/bin/docker-compose. Delete the file and run the command again.
Cannot connect to the Docker daemon Docker isn't running. Run systemctl restart docker and check systemctl status docker.

Running the command again is safe: it updates the packages and replaces the Compose binary.


Details

The command runs these steps, in order, without checking for errors between them:

  1. Adds the repository https://download.docker.com/linux/centos/docker-ce.repo with dnf config-manager.
  2. Installs docker-ce, docker-ce-cli, and containerd.io.
  3. Restarts and enables the docker service.
  4. Downloads Docker Compose 1.29.2 for the server's OS and CPU to /usr/local/bin/docker-compose.
  5. Makes it executable.
Installed Location
Docker Engine, CLI, containerd Installed by dnf; service name docker
Docker Compose 1.29.2 (standalone) /usr/local/bin/docker-compose

This installs the standalone Compose tool, run as docker-compose. It does not install the Compose plugin, so docker compose (with a space) isn't available.

[!NOTE] The Compose binary is downloaded from GitHub without a checksum check. Users in the docker group have root-equivalent access to the server; the command doesn't add anyone to it.


See also

Command Description
firewall Install a firewall on a GoAdmio server
allow Open a port in your server's firewall
nodejs Install the latest Node.js version on a GoAdmio server
proxmox Install Proxmox VE
package Install all base packages required by GoAdmio