Proxy & local domains

When an app declares a proxy host or a route path, kordrun runs a built-in reverse proxy and maps the hostnames in your /etc/hosts automatically.

Routing

Host-based routing

app web
  run npm run dev
  port 3000
  proxy app.local

kordrun adds 127.0.0.1 app.local to /etc/hosts (in a managed block) on start, so http://app.local reaches your app. Remove the entries any time:

kordrun hosts --clear

Path-based routing

Serve multiple apps under one host with route:

proxy_port 8000

app web
  run npm run dev
  port 3000
  route /

app api
  run cargo run
  port 4000
  route /api

Now http://localhost:8000/ hits web and http://localhost:8000/api hits api.

Privileged ports

To serve on port 80 (e.g. http://kordrun.local), set proxy_port 80. kordrun will ask for admin rights once to bind the privileged port.