How do you optimize Docker image size?
Jul 04, 2025 am 01:23 AMUsing lightweight basic images, merging and optimizing RUN instructions, and copying only necessary files are the key to reducing Docker images size. 1. Select lightweight basic images such as alpine, distroless or scratch to reduce unnecessary system components; 2. Merge multiple RUN commands and clean caches in time, such as combining apt-get update with installation commands, and delete /var/lib/apt/lists/*; 3. Exclude non-essential files through .dockerignore, use multi-stage construction to separate compilation and runtime dependencies, and copy only the necessary configuration and executable files into the final image. These methods can effectively reduce mirror size, improve construction and deployment efficiency, and reduce security risks.
Optimizing Docker image size is mostly about being intentional with what goes into the image and how you build it. A smaller image means faster builds, quicker deployments, and a reduced attack surface — all worth aiming for.
Use a Lightweight Base Image
One of the easiest ways to cut down on image bloat is to start with a small base image.
For example, using alpine
variants (like python:3.11-alpine
) can hold hundreds of megabytes off your final image. They're stripped-down versions of full OS images but still functional enough for most services.
If Alpine doesn't work for your stack (some packages are harder to compile on it), consider alternatives like distroless
or scratch
for truly minimal setups — especially useful in production-ready binaries like Go apps.
Just keep in mind:
- Smaller images might mean fewer debugging tools
- Some libraries expect certain system components that minimal images don't include
So pick one that fits your runtime needs without dragging in unnecessary extras.
Combine and Optimize RUN Instructions
Each RUN
, COPY
, or ADD
instruction creates a new layer in the image. Too many layers mean more overhead and larger images.
The trick here is to group related commands together.
Instead of doing this:
RUN apt-get update RUN apt-get install -y curl
Do this:
RUN apt-get update && \ apt-get install -y curl && \ rm -rf /var/lib/apt/lists/*
This reduces layers and cleans up cache files right away so they don't stick around in the final image.
Also, chain commands smartly:
- Always clean up package caches (
apt-get clean
,yum clean all
, etc.) - Delete temporary files or directories created during setup
- Avoid installing dev dependencies unless needed at runtime
Only COPY What You Need
It's common to see COPY . .
used liberally, but copying everything increases the image size unnecessarily.
Be selective.
Use .dockerignore
to exclude test files, logs, node_modules (if building inside Docker), and other non-essential assets.
For example, in a Node.js app:
COPY package*.json ./ RUN npm install COPY --from=builder /app/dist ./dist
This limits what gets copied and separates build-time from runtime dependencies, especially when using multi-stage builds.
And if you're working with compiled languages ??like Go or Java, build the binary first and only copy the executable config files — no source code needed in the final image.
That's basically it. The main idea is to stay aware of what's going into each layer and avoid carrying extra baggage. It's not complicated, but it makes a real difference when done consistently.
The above is the detailed content of How do you optimize Docker image size?. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

1. The Origin of .NETCore When talking about .NETCore, we must not mention its predecessor .NET. Java was in the limelight at that time, and Microsoft also favored Java. The Java virtual machine on the Windows platform was developed by Microsoft based on JVM standards. It is said to be the best performance Java virtual machine at that time. However, Microsoft has its own little abacus, trying to bundle Java with the Windows platform and add some Windows-specific features. Sun's dissatisfaction with this led to a breakdown of the relationship between the two parties, and Microsoft then launched .NET. .NET has borrowed many features of Java since its inception and gradually surpassed Java in language features and form development. Java in version 1.6

To develop a complete Python Web application, follow these steps: 1. Choose the appropriate framework, such as Django or Flask. 2. Integrate databases and use ORMs such as SQLAlchemy. 3. Design the front-end and use Vue or React. 4. Perform the test, use pytest or unittest. 5. Deploy applications, use Docker and platforms such as Heroku or AWS. Through these steps, powerful and efficient web applications can be built.

Docker and Kubernetes are leaders in containerization and orchestration. Docker focuses on container lifecycle management and is suitable for small projects; Kubernetes is good at container orchestration and is suitable for large-scale production environments. The combination of the two can improve development and deployment efficiency.

There are three ways to view the process information inside the Docker container: 1. Use the dockertop command to list all processes in the container and display PID, user, command and other information; 2. Use dockerexec to enter the container, and then use the ps or top command to view detailed process information; 3. Use the dockerstats command to display the usage of container resources in real time, and combine dockertop to fully understand the performance of the container.

Deploying a PyTorch application on Ubuntu can be done by following the steps: 1. Install Python and pip First, make sure that Python and pip are already installed on your system. You can install them using the following command: sudoaptupdatesudoaptinstallpython3python3-pip2. Create a virtual environment (optional) To isolate your project environment, it is recommended to create a virtual environment: python3-mvenvmyenvsourcemyenv/bin/activatet

Deploying and tuning Jenkins on Debian is a process involving multiple steps, including installation, configuration, plug-in management, and performance optimization. Here is a detailed guide to help you achieve efficient Jenkins deployment. Installing Jenkins First, make sure your system has a Java environment installed. Jenkins requires a Java runtime environment (JRE) to run properly. sudoaptupdatesudoaptininstallopenjdk-11-jdk Verify that Java installation is successful: java-version Next, add J

An efficient way to batch stop a Docker container includes using basic commands and tools. 1. Use the dockerstop$(dockerps-q) command and adjust the timeout time, such as dockerstop-t30$(dockerps-q). 2. Use dockerps filtering options, such as dockerstop$(dockerps-q--filter"label=app=web"). 3. Use the DockerCompose command docker-composedown. 4. Write scripts to stop containers in order, such as stopping db, app and web containers.

There are two ways to compare the differences in different Docker image versions: 1. Use the dockerdiff command to view changes in the container file system; 2. Use the dockerhistory command to view the hierarchy difference in the image building. These methods help to understand and optimize image versioning.
