Pivotal Knowledge Base


Garden-Linux Max Container Configuration


 Pivotal Cloud Foundry® (PCF) 1.7.x


This article describes how the default maximum number of Garden containers is derived and the recommended configuration to use it. It also describes the default CIDR range used for containers.



Garden is a platform-agnostic Go API for container creation and management, with pluggable backends for different platforms and runtimes. Garden is the containerization layer used by Diego. It provides a platform-independent, lightweight container abstraction that can run on Linux, Windows, and The Open Container Initiative Spec backends. 


Garden provides a method of managing isolated environments called containers. Containers can be configured with specific CPU, memory, disk, and network access according to your needs.

Garden-Linux has a configurable limit of 250 containers by default. This is the maximum number of containers that Garden will have running at any one time. It is not recommended to set garden.max_containers greater than 250.

The size of the container pool is bound by the size of the Garden-Linux network pool, which by default is and so, has room for 256/30 container subnets.

The CIDR can be configured via the following tab if required:

The Elastic Runtime tile > Networking > Applications Subnet. 

Note- The CIDR must be in a different range than the network used by the system VMs.

Both the explicit container limit, and the network-pool subnet are BOSH configurable.
garden.max_containers: 250 (default) [1] 



description: "Maximum number of containers that garden will have running at the same time. It is not recommended to set this larger than 250."


default: 250






description: "A CIDR subnet mask specifying the range of subnets available to be assigned to containers."




default: “”

Additional Information

Note- Modifying garden.max_containers in deployment manifest directly is not recommended. Also, any modifications will be overwritten when you click "Apply Change" on Ops Manager.

For additional information on the Garden-Linux container settings, please click here. [1]


Powered by Zendesk