Container Runtime Installation¶
Using the OVA?
Skip this section if you are using the OVA. Docker is pre-installed on the OVA.
Linux Runtime Options¶
To run the NodeZero container, you need either Docker or Podman installed. Choose the runtime that best fits your environment.
- 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. For additional help, see Docker's own installation documentation for Ubuntu or Debian.
Install Docker¶
Begin by updating your system and installing Docker:
sudo apt update
sudo apt install -y docker.io
Start and Enable Docker¶
Ensure that Docker starts automatically:
sudo systemctl start docker
sudo systemctl enable docker
Verify Docker Installation¶
Check the Docker version (must be 20.10+):
docker --version
sudo docker run hello-world
Additional Linux Distributions¶
If you're using a different Linux distribution, you can find corresponding installation guides in Docker's documentation:
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.