Home > Software > How to Fix “apt not found” Errors in Docker Containers

How to Fix “apt not found” Errors in Docker Containers

Anastasios Antoniadis

Learn how to resolve the ‘apt not found’ error in Docker with our concise guide.

Docker (1)

Encountering an “apt not found” error in Docker can be a frustrating experience, especially when trying to build images that rely on Debian or Ubuntu-based images. This issue usually arises when you’re trying to use the apt package manager in a Docker container that either doesn’t have it installed or is based on a non-Debian distribution. This article will guide you through understanding the root causes of this issue and provide solutions to fix it.

Understanding the Problem

The “apt not found” error occurs when the Docker container’s base image doesn’t include the apt package manager. This is common in two scenarios:

  1. The base image is not Debian-based: If you’re using an Alpine, CentOS, or any other non-Debian-based image, apt will not be available since these distributions use different package managers (e.g., apk for Alpine, yum or dnf for CentOS).
  2. Minimalist or custom images: Some Debian-based images might be stripped down for size and performance, removing apt and other utilities.

Solution 1: Ensure You’re Using a Debian-based Image

If you intended to use apt for package management, make sure your Dockerfile starts with a Debian-based image. The official Ubuntu or Debian images from Docker Hub come with apt pre-installed.

# Use an official Ubuntu base image
FROM ubuntu:latest


# Use an official Debian base image
FROM debian:stretch

After specifying a Debian-based image, the apt package manager should be available for installing packages.

Solution 2: Update and Install apt If Necessary

If you’re already using a Debian-based image and still encountering the error, it might be that the package list needs to be updated. Additionally, in very rare cases, you might need to explicitly install apt. Here’s how you can do both in your Dockerfile:

FROM debian:stretch

# Update package lists and install apt if necessary
RUN apt-get update && apt-get install -y apt

Solution 3: Switch to the Appropriate Package Manager

If your project does not specifically require Debian or Ubuntu, but you’re using a Docker image based on another distribution like Alpine, switch your Dockerfile commands to use the appropriate package manager. For Alpine Linux, you would use apk:

# Use an official Alpine base image
FROM alpine:latest

# Install packages using apk
RUN apk update && apk add --no-cache <package-name>

Solution 4: Use Multi-Stage Builds

If your application needs to be built in a Debian-based environment but needs to run in a lighter or different environment, consider using multi-stage builds. This allows you to use apt in the build stage and then copy the necessary artifacts to a final stage based on a different base image.

# Build stage
FROM ubuntu as builder
RUN apt-get update && apt-get install -y build-essential
# Add build instructions here

# Final stage
FROM alpine:latest
COPY --from=builder /app /app


The “apt not found” error in Docker usually stems from using a non-Debian-based image or a minimalist Debian-based image that doesn’t include apt. You can easily overcome this hurdle by carefully choosing your base image and using the correct package manager for your distribution. Multi-stage builds offer a flexible solution when your build and runtime environments differ, allowing for efficient Dockerfile configurations across various use cases.

Anastasios Antoniadis
Follow me
0 0 votes
Article Rating
Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x