Your first tunnel

All you need is a local server running and (optionally) a subdomain you want.

Start your app

Macha works with any server. The only thing it needs is a port number.

examples

# Node / Express on :3000
node server.js

# Python / FastAPI on :8000
uvicorn main:app --port 8000

# Anything — just know the port

2
Run Macha
```
macha --port 3000 --subdomain myapp
```
Replace 3000 with your app's port and myapp with any subdomain you want (letters, digits, hyphens — max 63 characters).
Subdomain optional: Skip --subdomain entirely and Macha generates a random 8-character subdomain for you — e.g. a1b2c3d4.macha.live.
3
Get your URL
```
  Dashboard → http://127.0.0.1:4040
✓  Tunnel: https://myapp.macha.live
```
Share https://myapp.macha.live with anyone. Open http://127.0.0.1:4040 to see requests in real time.

Subdomain taken? Subdomains are first-come, first-served per session. If myapp is already registered by another agent, pick a different one — or omit --subdomain for a random one. Subdomains are released when the agent disconnects, or automatically once the registration TTL (default 1 hour) elapses, whichever happens first.