Skip to content
nila-tunnel

Quick Start

1. Install nila-tunnel

Section titled “1. Install nila-tunnel”
Terminal window
# macOS / Linux
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/b-rajesh/nila-releases/releases/latest/download/nila-tunnel-installer.sh | sh


# Or via Homebrew
brew install b-rajesh/nila-tunnel/nila-tunnel

2. Set up

Section titled “2. Set up”
Terminal window
nila-tunnel install

Generates a Root CA and default config. No password prompt.

3. Start your app

Section titled “3. Start your app”
Terminal window
node server.js         # port 3000
python manage.py       # port 8000
cargo run              # whatever port

4. Register and start

Section titled “4. Register and start”
Terminal window
nila-tunnel register -d app.test -p 3000     # register a service
nila-tunnel start                            # start the proxy

First run prompts for your password once to trust the Root CA.

5. Open your browser

Section titled “5. Open your browser”

Navigate to https://app.test:8443/ — green lock, no warnings.

6. Register more services

Section titled “6. Register more services”

Services are hot-reloaded — register while the proxy is running:

Terminal window
nila-tunnel register -d api.test -p 4000
nila-tunnel register -d ai.test --path /v1/chat -p 8000 --request-timeout 120000

7. Check status

Section titled “7. Check status”
Terminal window
nila-tunnel status                    # human-readable
nila-tunnel status --json             # for AI agents and scripts

8. View logs

Section titled “8. View logs”
Terminal window
nila-tunnel log                       # daemon logs
nila-tunnel log requests              # structured request logs (JSONL)
nila-tunnel log requests -f           # follow in real time

9. Manage services

Section titled “9. Manage services”
Terminal window
nila-tunnel deregister -d api.test    # remove (hot-reloaded)
nila-tunnel restart                   # full restart if needed
nila-tunnel stop                      # stop the proxy

Clean URLs (with sudo)

Section titled “Clean URLs (with sudo)”
Terminal window
nila-tunnel start --mode privileged   # https://app.test/ (port 443)

Next steps

Section titled “Next steps”