How to configure CPU and memory limits in Docker

1 feb 2024 2 min di lettura
How to configure CPU and memory limits in Docker
Indice dei contenuti


In the dynamic world of containerization, Docker has emerged as a critical tool for building, deploying, and managing containerized applications. However, Docker's efficiency largely depends on how resources are managed. Setting appropriate memory and CPU limits is critical to optimizing Docker performance, ensuring that each container receives the resources it needs without overloading the host system. This article delves into practical strategies for setting these limits effectively, with examples for both Dockerfile and Docker Compose.

Understand resource constraints in Docker

Docker containers, by default, can use an unlimited amount of host machine resources. This unrestricted access can lead to resource contention, decreased performance, and potential system instability. Setting explicit memory and CPU limits prevents these issues, allowing for better resource allocation and improved overall performance.

Setting limits with Docker Run

The docker run command is used to run a container from an image. Resource limits can be specified directly in this command, providing an easy way to control resource usage for individual containers.

1. Memory limit example

To limit memory for a container at run time, use the --memory or -m flag:

docker run -m 500m my-image

This command limits the container to 500 MB of memory.

2. CPU limit example

To limit CPU usage, you can use the --cpus flag:

docker run --cpus 2 my-image

This sets the container to use a maximum of 2 CPUs.

Setting limits in Docker Compose

Docker Compose is a tool for defining and running multi-container Docker applications. You can define resource limits in the docker-compose.yml file, which offers more flexibility and readability than the Dockerfile.

1. Example of memory and CPU limits

Create a docker-compose.yml file and define resource-constrained services as follows:

version: "3"
 image: my-image
 cpus: '1.5'
 memory: 500M
 cpus: '0.5'
 memory: 200M

In this example, my service is limited to using 1.5 CPU and 500 MB of memory. The reservation block specifies the minimum resources reserved for this service.

Best practices for setting resource limits

  • Analyze workload requirements: Understand the resource needs of your application to set appropriate limits.
  • Monitor container performance: Regularly monitor performance to adjust resource limits as needed.
  • Avoid overallocation: Setting limits that are too high can lead to inefficient use of resources.
  • Balance limits and reservations: Use reservations for critical services to ensure they receive the minimum required resources.


Effective resource management is key to optimizing Docker performance. By setting memory and CPU limits, via Dockerfile or Docker Compose, you can ensure efficient and stable operation of your containerized applications. Always remember to tailor these settings to your specific needs and monitor performance to make any necessary changes. This proactive approach to resource management will lead to a more robust, efficient, and scalable Docker environment.

Buy me a coffeeBuy me a coffee

Supportaci se ti piacciono i nostri contenuti. Grazie.

Successivamente, completa il checkout per l'accesso completo a
Bentornato! Accesso eseguito correttamente.
Ti sei abbonato con successo a
Successo! Il tuo account è completamente attivato, ora hai accesso a tutti i contenuti.
Operazione riuscita. Le tue informazioni di fatturazione sono state aggiornate.
La tua fatturazione non è stata aggiornata.