---
title: "proxy in config.yaml"
url: https://devlanes.run/docs/reference/config/user/proxy/
description: "Reference for the proxy key in ~/.devlanes/config.yaml."
---

# proxy in config.yaml

A top-level key of [`~/.devlanes/config.yaml`](/docs/reference/config/user/).

## `proxy`

Type: mapping.

Ports of the daemon's HTTP/HTTPS proxy, which serves every `hosts` entry, and whether other devices on the network may connect to it.

```yaml devlanes-user
proxy:
  http_port: 80
  https_port: 443
  lan: false
  server_timing: true
  via: true
```

### `proxy.http_port`

Type: integer. Default: `80`.

Port for plain HTTP; defaults to 80, falling back to 8080 like `https_port`, and must differ from it. While HTTPS runs it redirects known hostnames to HTTPS; without a CA it serves them over plain HTTP.

```yaml devlanes-user
proxy:
  http_port: 80
```

### `proxy.https_port`

Type: integer. Default: `443`.

Port the HTTPS proxy listens on; defaults to 443. When the port is taken or not allowed (low ports on Linux need extra permission), the daemon falls back to 8443 and service URLs carry the port.

```yaml devlanes-user
proxy:
  https_port: 443
```

### `proxy.lan`

Type: boolean. Default: `false`.

Accept connections from other devices on the network; defaults to false, which refuses every peer that is not this machine. Those devices must still resolve the hostnames to this machine and trust the CA.

```yaml devlanes-user
proxy:
  lan: false
```

### `proxy.server_timing`

Type: boolean. Default: `true`.

Add a `Server-Timing` header to every response, after any the service sent, with the time devlanes added (`devlanes`), waits for a starting service or a frozen lane (`devlanes-wait`), the connection to the service (`devlanes-connect`) and the service's own time (`devlanes-upstream`). Browser dev tools show these in the request's Timing tab. For a lane on a remote box, `devlanes-upstream` includes the connection to the box, which `devlanes-tunnel` estimates from its latest ping. Defaults to true; set false if a client or test compares response headers exactly.

```yaml devlanes-user
proxy:
  server_timing: true
```

### `proxy.via`

Type: boolean. Default: `true`.

Add `Via: 1.1 devlanes.run` to every response the proxy forwards from a service (`1.1 devlanes.run (remote)` for lanes on a remote box), so a client can tell that devlanes sat in between. Defaults to true; set false if a client or test compares response headers exactly.

```yaml devlanes-user
proxy:
  via: true
```
