From NeoRouterWiki

Jump to: navigation, search


Setup NeoRouter Client

Install NeoRouter Client for Windows

1. Visit and download NeoRouter Free for Windows.

2. Run the installation wizard you have just downloaded, choose NeoRouter Network Explorer, and click Next.

3. (Vista Only) you may be prompted with a security warning. NeoRouter setup is installing a virtual LAN network driver which is not yet certified by Microsoft. NeoRouter is guaranteed to be free of spyware, adware or virus. This driver component is essential to NeoRouter and please allow the setup to continue.

For more information on Windows Logo program, please visit:

Rant: Microsoft is notorious for charging a large fee for its Windows Logo program. This prohibits start-up companies like us from becoming certified.

4. If your computer is behind an ISA firewall, please read NeoRouterWiki:ClientSetupISAFirewall. Most users can skip this step.

5. Finish

Install NeoRouter Client for Linux

1. Visit and download NeoRouter Client for your Linux distribution.

2. Uninstall previous version, if needed:

  • Ubuntu & Debian: sudo dpkg -r nrclient
  • Fedora, RedHat & SUSE: sudo rpm -e nrclient

3. Install

  • Ubuntu & Debian: sudo dpkg -i nrclient-<version>-<release>-<arch>.deb
  • Fedora, RedHat & SUSE: sudo rpm -i nrclient-<version>-<release>-<arch>.rpm

4. Configure firewall

  • Fedora, RedHat & SUSE: You may need to disable outbound firewalling to allow NeoRouter client service (nrservice) to establish a P2P connection. Otherwise nrservice will establish routed connection via server.
  • More info on NAT traversal and STUN:;

5. Configure nrclient

  • Use one of the following commands as appropriate to connect with a running NeoRouter server:
    • nrclientcmd -d localhost -u serverbox -p password
    • nrclientcmd -d NRserverIP -u jdoe -p password
    • nrclientcmd -d NRregisteredDomain -u jdoe -p password

6. Launch

  • Ubuntu & Debian:
    • /etc/init.d/ restart
    • ifconfig nrtap
  • Fedora (and likely others):
    • systemctl restart nrservice
    • ifconfig nrtap


nrclient contains two executables: nrservice and nrclientcmd. nrservice will automatically start after installation and every time Linux starts. Run nrclientcmd to log in your virtual LAN.

Install NeoRouter Client for Mac

1. Visit and download NeoRouter Client for Mac.

2. Uninstall previous version, if needed:

  • sudo /Library/NeoRouter/ {userdata|taptun}
  • can optionally remove tuntap driver and NeoRouter user data
  • All NeoRouter user data is written to /usr/local/ZebraNetworkSystems/NeoRouter

3. Install

  • Please first install the latest tuntap driver from
  • Double-click nrclient-<version>-<release>.tar.gz to expand it, then double-click on the nrclient-<version>-<release>.mpkg to launch installer wizard.

4. Launch

NeoRouter is installed under /Library/NeoRouter folder. In the folder you can find two executables: nrservice and nrclientcmd. nrservice will automatically start after installation and every time OS starts. Run nrclientcmd to log in your virtual LAN.

You can also create a desktop shortcut to nrclientcmd using this command: "ln /Library/NeoRouter/nrclientcmd ~/Desktop". Then you can launch nrclientcmd by simply double-clicking on the shortcut icon.

  • Tip: Manually start/stop nrservice

0.9.9 uses launchd. Use "launchctl remove com.neorouter.nrservice" take over control from launchd. Then you can run "sudo /Library/NeoRouter/nrservice" or "sudo killall nrservice".

0.9.8 uses startup items. Use "/Library/StartupItems/nrservice/nrservice {start|stop}".

Install NeoRouter client for FreeBSD

1. Visit and download NeoRouter client for FreeBSD.

2. Copy it to /tmp

3. Switch to su user

4. cd /tmp; tar zxvf nrclient*.tgz

5. cd /tmp/nrclient

6. make install

  • To uninstall NeoRouter client for FreeBSD

1. Switch to su user


Install NeoRouter Client for OpenWrt


  • NeoRouter Client is fully tested on Asus WL-520G Premium v2 with Kamikaze 8.09.
  • NeoRouter Client should work on all broadcom based routers with >=8MB flash. We will be happy to support other platforms, and you can post your request at our forum.

1. Connect to the router using ssh or telnet

2. Update available install packages using command

   opkg update

3. Install

   opkg install

4. Enable P2P (Optional)

Warning: this will disable the firewall on this device to allow P2P NAT traversal. Only do this if this device is not on the public network, or this change may compromise its security. (I use my WL-500GP v2 as a NAS. It is behind my public-facing router, so it is fully protected from intruders).

If this device is your public-facing router, then skip this step. NRClient will connect to peers using relay-mode. It's a bit slower, but the device has the full firewall protection.

To drop firewall and enable P2P, you can edit /etc/firewall.user and add the following:

   iptables -t nat -A prerouting_wan -p tcp -j ACCEPT
   iptables        -A input_wan      -p tcp -j ACCEPT
   iptables -t nat -A prerouting_wan -p udp -j ACCEPT
   iptables        -A input_wan      -p udp -j ACCEPT

5. Join NR Domain

Run /usr/bin/nrclientcmd and join your NeoRouter domain.

6. Turn your router into a file or backup server (Optional)

Because NeoRouter is so small, you have plenty of space left on the flash for other packages.

You can enable USB storage and Samba server, and your router will become a file server. You can even install rsync and turn it into a backup server. NeoRouter's remote access and VPN service will allow you to securely access the files from anywhere.

This solution is a lot cheaper than Small Business server or Windows Home server.

   Enable USB Storage:
   Install Samba:
   Install rsync: