Skip to content

Usage

To forward public traffic to a local port (e.g., port 3000):

Terminal window
nipo http 3000

Start a tunnel with a custom subdomain:

Terminal window
nipo http 3000 --subdomain myapp
# Or shorthand:
nipo http 3000 -s myapp

You can define multiple tunnels in a local configuration file named nipo.yml:

default_subdomain: "myproject"
tunnels:
- name: web
port: 3000 # Uses default subdomain: myproject-web
- name: api
port: 8080
subdomain: "my-custom-api" # Overrides and uses: my-custom-api
  • Start all tunnels simultaneously:
    Terminal window
    nipo start
  • Start specific tunnels from the config file:
    Terminal window
    nipo start web

Check the active configuration settings:

Terminal window
nipo config

Nipo detects your system locale, but you can change the display language dynamically:

Terminal window
nipo config --language vi # Switch to Vietnamese
nipo config --language en # Switch to English

These preferences are saved globally in ~/.nipo/config.yml.