Skip to content

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

proxy in config.yaml

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

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.

~/.devlanes/config.yaml
proxy:
http_port: 80
https_port: 443
lan: false
server_timing: true
via: true

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.

~/.devlanes/config.yaml
proxy:
http_port: 80

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.

~/.devlanes/config.yaml
proxy:
https_port: 443

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.

~/.devlanes/config.yaml
proxy:
lan: false

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.

~/.devlanes/config.yaml
proxy:
server_timing: true

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.

~/.devlanes/config.yaml
proxy:
via: true