Introduction

When building Docker images based on Debian or Ubuntu, you often see the warning debconf: delaying package configuration, since apt-utils is not installed. This is not an error. It is a harmless warning that means apt-utils (which provides apt-ftparchive and the debconf frontend) is not present in the minimal base image. The packages still install correctly. You can silence the warning by installing apt-utils first, or by setting the DEBIAN_FRONTEND=noninteractive environment variable.

The Warning

FROM ubuntu:22.04
RUN apt-get update && apt-get install -y curl

debconf: delaying package configuration, since apt-utils is not installed

This warning appears because the base image ships with a minimal package set. The debconf system wants apt-utils for its dialog frontend, but falls back to a basic frontend when it is missing. Packages still install correctly. Only the configuration dialogs are skipped.

Fix 1: Install apt-utils First

1FROM ubuntu:22.04
2
3RUN apt-get update && \
4    apt-get install -y --no-install-recommends apt-utils && \
5    apt-get install -y curl wget git
6
7# No more "delaying package configuration" warning

Installing apt-utils before other packages gives debconf the frontend it expects.

Fix 2: Set DEBIAN_FRONTEND=noninteractive (Recommended)

1FROM ubuntu:22.04
2
3ENV DEBIAN_FRONTEND=noninteractive
4
5RUN apt-get update && \
6    apt-get install -y curl wget git

DEBIAN_FRONTEND=noninteractive tells debconf to skip all interactive prompts and use default values. This silences the warning and prevents any package from trying to open a dialog during installation, which would hang the build.

For a single RUN instruction without setting it globally:

RUN DEBIAN_FRONTEND=noninteractive apt-get install -y tzdata

Fix 3: Use ARG Instead of ENV

1FROM ubuntu:22.04
2
3# ARG only exists during build, not in the final image
4ARG DEBIAN_FRONTEND=noninteractive
5
6RUN apt-get update && apt-get install -y curl

Using ARG instead of ENV prevents DEBIAN_FRONTEND from persisting in the final container, which could mask issues if users try to interactively configure packages inside the running container.

Complete Dockerfile Pattern

1FROM ubuntu:22.04
2
3ARG DEBIAN_FRONTEND=noninteractive
4
5# Update and install in a single layer to reduce image size
6RUN apt-get update && \
7    apt-get install -y --no-install-recommends \
8        apt-utils \
9        curl \
10        wget \
11        ca-certificates \
12        gnupg && \
13    # Clean up apt cache to reduce image size
14    rm -rf /var/lib/apt/lists/*

Key practices:

• --no-install-recommends avoids pulling unnecessary packages
• Combining update and install in one RUN prevents stale cache issues
• rm -rf /var/lib/apt/lists/* reduces the final image size

Related Warning: tzdata Interactive Prompt

The tzdata package prompts for a time zone during installation, which hangs Docker builds:

1# WRONG: hangs waiting for user input
2RUN apt-get install -y tzdata
3
4# RIGHT: skip the prompt
5ARG DEBIAN_FRONTEND=noninteractive
6ENV TZ=UTC
7RUN apt-get update && apt-get install -y tzdata

Setting TZ provides the default time zone so tzdata does not need to ask.

Alpine-Based Images

Alpine uses apk instead of apt, so this issue does not apply:

1FROM alpine:3.18
2
3# apk has no debconf system, so no such warnings
4RUN apk add --no-cache curl wget git

If you see apt-utils issues frequently, consider switching to Alpine for smaller images and no apt-related warnings.

Debugging apt Issues in Docker

1# See what packages are available
2RUN apt-get update && apt-cache search apt-utils
3
4# Check if apt-utils is installed
5RUN dpkg -l | grep apt-utils
6
7# Verbose installation to debug failures
8RUN apt-get update && apt-get install -y -o Debug::pkgProblemResolver=yes apt-utils
9
10# Check debconf frontend
11RUN debconf-show debconf

Multi-Stage Builds

In multi-stage builds, only the final stage matters for the runtime image:

1# Build stage: warnings here are harmless
2FROM ubuntu:22.04 AS builder
3RUN apt-get update && apt-get install -y build-essential cmake
4
5# Runtime stage: minimal, no apt warnings
6FROM ubuntu:22.04
7COPY --from=builder /app/build/myapp /usr/local/bin/

Common Pitfalls

• Treating the warning as an error: The debconf: delaying package configuration message is a warning, not an error. Packages install correctly without apt-utils. Do not add complex workarounds for a cosmetic issue.
• Running apt-get update and apt-get install in separate RUN layers: The package index from update is cached in the layer. If the base image changes, the cached index becomes stale, causing install to fail with "Unable to locate package." Always combine them.
• Setting DEBIAN_FRONTEND=noninteractive as ENV in production images: This persists in the final container and suppresses all dpkg-reconfigure prompts. Use ARG instead so it only applies during build.
• Missing --no-install-recommends: Without this flag, apt installs recommended packages (not just dependencies), which can double your image size with packages you do not need.
• Forgetting rm -rf /var/lib/apt/lists/*: The apt package lists consume 30-50 MB. Always clean them at the end of your RUN instruction to keep images small.

Summary

• The apt-utils warning is harmless. Packages install correctly without it
• Set ARG DEBIAN_FRONTEND=noninteractive to silence the warning and prevent interactive prompts
• Install apt-utils first if you want the debconf dialog frontend
• Combine apt-get update and apt-get install in a single RUN layer
• Use --no-install-recommends and clean apt/lists to minimize image size
• Consider Alpine-based images to avoid apt issues entirely