Skip to content

devlanes is in beta and not ready for production use.Report an issue

startup in config.yaml

A top-level key of ~/.devlanes/config.yaml.

Type: mapping.

How many services may be starting at the same time across all lanes and projects, so a large start does not overload the machine. Defaults to one start per CPU core.

~/.devlanes/config.yaml
startup:
max: 4
mode: fixed

Type: integer.

Adaptive starting window; defaults to max, so starts run at full speed until the machine is under pressure. Set it lower to ramp up from a few slots instead; never above max.

~/.devlanes/config.yaml
startup:
initial: 2

Type: integer.

Most services starting at once: the constant window in fixed mode and the ceiling in adaptive mode. Defaults to the number of CPU cores; all ignores it.

~/.devlanes/config.yaml
startup:
max: 8

Type: string. Default: adaptive.

adaptive, fixed or all; default adaptive. A starting service holds its slot until its ready check (tcp, http, log or cmd) passes, it fails, or slot_timeout passes; one without a check (ready: started) holds it until it settles (settle_cpu).

Values:

  • adaptive: Begin each burst of starts at initial (by default max, full speed). Halve the slots after 3 s above 90% CPU or when the system reports memory pressure, start nothing while that pressure is critical, and add a slot every 2 s while system CPU stays below target_cpu, up to max.
  • fixed: Allow max starts at a time, never more or fewer. A start also waits while free memory cannot fit what it needs.
  • all: Start every service immediately, with no limit and no memory check.
~/.devlanes/config.yaml
startup:
mode: adaptive

Type: byte size.

Free memory every new start must leave, on top of the memory the services already starting are expected to still need (each one’s past startup peak, or 512 MiB without history). Defaults to 10% of RAM, at most 2GiB; 0B turns it off. A start with nothing else starting never waits for it. all ignores it.

~/.devlanes/config.yaml
startup:
reserve_memory: 2GiB

Type: percentage. Default: 10%.

Only for services without a ready check (ready: started, the default for a service without hosts): such a service gives its slot back once its process tree uses less than this share of one core for 2 s, meaning it has finished starting up. Services with a tcp, http, log or cmd check keep their slot until the check passes instead. Defaults to 10%.

~/.devlanes/config.yaml
startup:
settle_cpu: 10%

Type: duration. Default: 20s.

Longest a starting service holds its slot; after it, the next queued service may start even if this one is not ready, so services waiting on each other cannot block the queue. Defaults to 20s and must be above zero; the service itself keeps starting.

~/.devlanes/config.yaml
startup:
slot_timeout: 15s

Type: percentage. Default: 75%.

System CPU use below which adaptive mode adds slots; defaults to 75%, and must be above 0% and at most 100%. Lower it to keep the machine responsive during large starts; other modes ignore it.

~/.devlanes/config.yaml
startup:
target_cpu: 75%