Container Runtime Installation¶
NodeZero requires a container runtime to operate. Docker and Podman are both supported. Choose the runtime that best fits your environment.
Which should I choose?
- Docker is recommended for Ubuntu- and Debian-based systems.
- Podman is recommended for RHEL 9+ and other systems where Podman is the default container runtime. Podman 4.0+ is required.
Select a tab below to display complete installation instructions for either Docker or Podman.
Follow these steps to install and configure Docker. See the Docker Documentation for additional help.
Install Docker¶
Begin by updating your system and installing Docker:
sudo apt update
sudo apt install -y docker.io
Start and Enable Docker¶
Ensure Docker starts automatically:
sudo systemctl start docker
sudo systemctl enable docker
Verify Docker Installation¶
Check the Docker version:
docker --version
sudo docker run hello-world
Follow these steps to install and configure Podman on RHEL-based systems. For additional help, see the Podman documentation.
Install Podman¶
Install Podman using your package manager:
sudo dnf install -y podman
Verify Podman Installation¶
Check the Podman version (must be 4.0+):
podman --version
sudo podman run hello-world
Podman version and sudo requirements
NodeZero requires Podman 4.0+. Podman 4.0+ is available on RHEL 9+. Earlier versions might lack required networking and SELinux features.
NodeZero requires root-level access for mount operations and image store access. When using Podman, NodeZero always runs containers with sudo.
NodeZero container getting shut down prematurely?
If the container running NodeZero is getting shut down prematurely, an EDR (Endpoint Detection and Response) service might be running on the NodeZero host and blocking the execution of the container. Check for any EDRs on the NodeZero host and disable them. This allows NodeZero to run unimpeded from the host machine.