Docker – Ubuntu – bash: ping: command not found

When running an Ubuntu-based Docker container, you might encounter this error:

bash: ping: command not found

This usually happens when you try to test network connectivity inside the container using the ping command. Let’s break down why this occurs and how to fix it.

1️⃣ Why Is ping Missing in Ubuntu Docker Images?

Ubuntu Docker images are designed to be lightweight. The official images (like ubuntu:20.04 or ubuntu:22.04) contain only the bare minimum packages needed to run.

The ping utility is part of the iputils-ping package, which is not included by default in these images. That’s why you see the error.

2️⃣ How to Fix It

To use ping inside your Ubuntu container, you need to install the required package.

✅ Option 1: Install iputils-ping inside the running container

If you’re already inside a container:

apt-get update && apt-get install -y iputils-ping

Now, you can run:

ping google.com

✅ Option 2: Add ping to Your Dockerfile

If you want every container built from your image to have ping preinstalled, modify your Dockerfile:

FROM ubuntu:22.04

RUN apt-get update && \
    apt-get install -y iputils-ping && \
    rm -rf /var/lib/apt/lists/*

Then rebuild your image:

docker build -t ubuntu-with-ping .

✅ Option 3: Use inetutils-ping (Alternative)

Some distributions prefer inetutils-ping over iputils-ping. If the above doesn’t work, try:

apt-get update && apt-get install -y inetutils-ping

3️⃣ Best Practices

  • Keep in mind that ping is often only used for debugging and testing. For production containers, avoid installing unnecessary packages to keep images small.
  • Instead of installing ping, consider using:
    • curl or wget for HTTP-based checks
    • nc (netcat) for TCP connectivity testing

📌 Summary

The error bash: ping: command not found in an Ubuntu Docker container happens because the official images don’t include ping by default.

To fix:

  • 🔹 Install it manually: apt-get update && apt-get install -y iputils-ping
  • 🔹 Or add it in your Dockerfile for repeatable builds
  • 🔹 Use alternatives like curl or nc for production-friendly testing

With this, you’ll be able to test networking inside your containers with ease.

Sharing Is Caring:

Leave a Comment