Your first route

This is the local-only routeup flow. It does not need an account, token, public server, or network access.

1. Run setup once

routeup setup

Setup creates a local certificate authority, adds it to your OS trust store, lets routeup answer on port 443, and starts the background agent. You may be asked for Touch ID or your password once.

2. Start any local app

Use whatever you already run in development. If you just want something to test against, start a throwaway static server on port 8080:

python3 -m http.server 8080

Your real dev server works the same way, Vite, Next, Rails, a Go service, anything that listens on a local port.

3. Serve it through routeup

routeup serve example-app --port 8080

routeup prints the route it claimed and the targets it is proxying to:

route: example-app
local: https://example-app.localhost
targets:
  /        http://localhost:8080

press Ctrl-C to stop

Open:

https://example-app.localhost

The route stays stable even if you later move the app to another local port.

Useful checks

List active routes:

routeup routes

Check setup, trust, port binding, and agent health:

routeup doctor