---
title: "User file reference"
url: https://devlanes.run/docs/reference/config/user/
description: "Every top-level key of ~/.devlanes/config.yaml, each with a one-sentence summary."
---

# User file reference

Top-level keys of `~/.devlanes/config.yaml`. Each has a page with every key under it.

- [`daemon`](/docs/reference/config/user/daemon/): The daemon's lifetime: whether it stops on its own once nothing runs and no TUI is open.
- [`history`](/docs/reference/config/user/history/): How long the database keeps records of finished service and task runs, and of remote boxes that no longer connect.
- [`hostnames`](/docs/reference/config/user/hostnames/): How lane hostnames such as `api.acme2.localhost` resolve to this machine: the strategy (`resolver`), its `tld`, and whether names also go into `/etc/hosts` (`hosts_file`).
- [`lanes`](/docs/reference/config/user/lanes/): Where lane data folders (`lane.data_path`) live on this machine, and how long a lane may sit without activity before devlanes throttles or freezes it.
- [`logs`](/docs/reference/config/user/logs/): How much service output devlanes keeps under `~/.devlanes/logs`, by age and total size.
- [`metrics`](/docs/reference/config/user/metrics/): How long CPU and memory history stays in the daemon's database.
- [`ports`](/docs/reference/config/user/ports/): Port range that every lane of every project takes its block of ports from, so lanes never collide.
- [`proxy`](/docs/reference/config/user/proxy/): Ports of the daemon's HTTP/HTTPS proxy, which serves every `hosts` entry, and whether other devices on the network may connect to it.
- [`remote`](/docs/reference/config/user/remote/): Settings for `devlanes remote connect`: boxes reached by a command, and how this machine serves clients when it is a box.
- [`start`](/docs/reference/config/user/start/): What a plain `devlanes start` (no services, no `--profile`) brings up: the services the lane ran before, or its default selection.
- [`startup`](/docs/reference/config/user/startup/): How many services may be starting at the same time across all lanes and projects, so a large start does not overload the machine.
- [`state`](/docs/reference/config/user/state/): Size budget for the daemon's database; past it, the oldest metrics and history are deleted before their retention ends.
- [`terminal`](/docs/reference/config/user/terminal/): Terminal integration of the CLI, written as a mapping with `progress` (the tab's progress bar during starts).
- [`tls`](/docs/reference/config/user/tls/): Which certificate authority signs the proxy's HTTPS certificates (`ca`), and which stores `devlanes setup` installs it into (`trust`).
- [`tui`](/docs/reference/config/user/tui/): Whether start commands open the terminal UI, how it looks, and what quitting it does with running lanes.
- [`updates`](/docs/reference/config/user/updates/): Release checks: whether the daemon looks for newer devlanes releases (`mode`), and whether the TUI shows release highlights after an update (`highlights`).

```yaml devlanes-user
hostnames:
  resolver: localhost
ports:
  range: 20000-32767
terminal:
  progress: auto
```
