From NeoRouterWiki

(Difference between revisions)
Jump to: navigation, search
(Install NeoRouter server for Mac)
(Install NeoRouter server for FreeBSD)
Line 216: Line 216:
6. make install
6. make install
** To uninstall NeoRouter server for FreeBSD
1. Switch to su user
= Command Line Interface =
= Command Line Interface =

Revision as of 19:10, 12 September 2010


Setup NeoRouter Server


Please setup NeoRouter server on only one computer within a physical network. On all other computers, please setup the NeoRouter client.

Understand your options

Option 1 NeoRouter server for Windows: It requires a PC or a Home/Small Business server that is always powered on, has stable Internet connection and running Windows XP SP2 or above.

Option 2 NeoRouter server for Linux: We currently support Ubuntu, Fedora and SUSE.

Option 3 NeoRouter server for Linux-based firmware, like Tomato, OpenWrt, DD-Wrt.

Install NeoRouter server for Windows

1. Visit and download NeoRouter Standard Edition for Windows.

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

3. Setup a domain name that can uniquely identify your virtual LAN. You will need to enter the domain name in the "log on to" box during sign in. ee sign in for details.

4. Setup the administrator account for your domain. You will need to enter the username and password during signin. See sign in for details.

5. For secure purpose, it’s highly recommended to setup your router to enable port forwarding to the NeoRouter server at TCP port 32976 for remote client connections.

NeoRouter server supports Universal Plug and Play (UPnP) as well. On Windows 2000/2003/XP, you can use UPnP instead of port forwarding.If the server PC is behind a residential router, you need to ensure UPnP is enabled on the router.

If your router does not support UPnP, please add a static port forward entry.

 Note: on some hard-to-troubleshoot cases [read:quirky computers & routers], you 
       might wish to perform ALL of the following:
   a. Enable UPnP on your router, AND
   b. Enable port forwarding on your router for BOTH TCP and UDP, AND
   c. Create rules on your personal firewall allowing BOTH TCP and UDP
      on your specific port for NRServer.exe, AND
   d. Manually disable your network connection, stop and then restart your router, 
      and finally re-enable your network connection - AND
   e. Manually stop and restart the "NeoRouter Connection Server" thru the Windows 
      Services applet, instead of using the "Restart Server" option within 
      Configuration Explorer.
   f. If at the end NeoRouter Server works properly and you believe you've overly 
      exposed your security, you might wish to UNDO the possibly redundant steps, by 
      carefully experimenting undoing one by one and re-testing at each step until 
      things break - then redo the last undone step.
      *** by sdrubble, 2009-09-19 ***

6. Finish

Install NeoRouter server for Linux

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

2. Install

  • Ubuntu & Debian: sudo dpkg -i nrserver-<version>-<release>.i386.deb
  • Fedora & SUSE: sudo rpm -i nrserver-<version>-<release>.i386.rpm

Note - OpenSSL on Fedora: NeoRouter is compiled using openssl 0.9.8g on Fedora 9. If you have an older version of Fedora, please upgrade the openssl package. You may also need to add the following symbol links:

   cd /lib
   ln -s
   ln -s

3. Configure firewall:

  • Fedora:

In a terminal, run command "sudo nano /etc/sysconfig/iptables", add "-A INPUT -m state --state NEW -m tcp -p tcp --dport 32976 -j ACCEPT" before "COMMIT".

  • SUSE:
    • a. Launch firewall configuration tool
    • b. Choose "Allowed Services" in the left panel
    • c. Choose "External Zone" in the first drop-down box
    • d. Choose "NeoRouter server" in the second drop-down box
    • e. Click "Add" button
    • f. Click "Next"
    • g. Click "Finish" to save the changes
  • Ubuntu does not support firewall by default.

If you got any firewall enabled then its the best to read its manual how to open the ports. Default port of the NeoRouter server is 32976 TCP

4. Configure nrserver: The next step is to use NR Configuration Explorer to configure your nrserver. Currently Configuration Explorer is only available on Windows. We are porting it to other platforms.

  • a. Install NeoRouter client for Windows on a Windows PC in the same LAN.
  • b. Launch NeoRouter Configuration Explorer, enter your Linux user in the username field the IP address of the Linux server in "log on to" field. Proceed to sign in.
  • c. Now the Configuration Explorer is connected to nrserver on your Linux box so that we can change the settings.

5. Setup domain: NeoRouter domain functions like a dynamic DNS server. You can enter domain instead of server IP when signing in NeoRouter client.

6. User Accounts: you can Sign In NeoRouter Network Explorer or configuration console using the same account you use to sign into Linux. You can also create other NeoRouter accounts in the configuration console. This is the best done with NeoRouter Configuration Explorer, description below.

7. You are ready to accept clients to join your network. Notice, server will not be visible as a machine in the network.

Install NeoRouter server for OpenWrt


  • NeoRouter server is fully tested on LinkSys WRT54GL and Asus WL-520GU with Kamikaze 8.09.
  • NeoRouter server should work on all broadcom based routers. 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. Edit firewall setting for the NeoRouter server listening port.

Edit /etc/firewall.user and add the following:

   iptables -t nat -A prerouting_wan -p tcp --dport 32976 -j ACCEPT
   iptables        -A input_wan      -p tcp --dport 32976 -j ACCEPT

5. Install NeoRouter client on any Windows computer, run NeoRouter Configuration Explorer to log on to the router using the router's root account and password, then configure the domain information.

6. Setup Domain and User Accounts: see instructions under "Install NeoRouter server for Linux".

Install NeoRouter server for Tomato firmware


  • NeoRouter server is fully tested on LinkSys WRT54GL and Asus WL-520GU.

1. Flash your router

NeoRouter server for Tomato is provided as a custom build of the full tomato firmware in TRX format. You can download the TRX file from from

Please visit OpenWRT Wiki for instructions on flashing your router with TRX.

2. In tomato UI – Administration – Jffs2, enable jffs and format if needed

3. In tomato UI – Administration – scripts – WAN up,

For v0.9.7 and later, add "/usr/bin/ start"

For v0.9.6 or earlier versions, add "/usr/bin/ start"

4. Reboot router

5. Setup Domain and User Accounts: see instructions under "Install NeoRouter server for Linux".


  • By default, our built-in script can automatically open firewall for the tomato router's LAN IP address. But if you are using v0.9.4.881 or older AND you have changed the default LAN IP address from to a different LAN IP Address, you need to edit firewall setting manually to open up the listening port for NeoRouter.

In tomato UI – Administration – scripts – Firewall, add following lines:

  iptables -t nat -A PREROUTING -p tcp --dport 32976 -j ACCEPT
  iptables        -A INPUT      -p tcp --dport 32976 -j ACCEPT

  • If you have trouble signing into NeoRouter Network Explorer from a remote client, please try DISABLE the Inbound Connection Logging.

In tomato UI - Status - Logs - Logging Configuration, disable Inbound Connection

Install NeoRouter server for Fonera firmware

Please see dedicated page here.

Install NeoRouter server for Mac

1. Visit and download NeoRouter server for Mac.

2. Uninstall previous version, if needed:

  • sudo /Library/NeoRouter/ {userdata}
  • can optionally remove user data. All NeoRouter user data is written to /usr/local/ZebraNetworkSystems/NeoRouter.

3. Install

  • Double-click nrserver-<version>-<release>.tar.gz to expand it, then double-click on the nrserver-<version>-<release>.mpkg to launch installer wizard.

4. Launch

NeoRouter is installed under /Library/NeoRouter folder. nrserver will automatically start after installation and every time OS starts.

  • Tip: Manually start/stop nrserver

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

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

5. Setup Domain and User Accounts: see instructions under "Install NeoRouter server for Linux".

Install NeoRouter server for FreeBSD

1. Visit and download NeoRouter server for FreeBSD.

2. Copy it to /tmp

3. Switch to su user

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

5. cd /tmp/nrserver

6. make install

    • To uninstall NeoRouter server for FreeBSD

1. Switch to su user


Command Line Interface

From v0.9.9, the server executable supports more command line parameters for maintaining the settings. It's very useful for the Linux/Mac/in-a-box users, who don't have a Windows system to run the Configuration Explorer. With these commands, they can set most settings defined in the Configuration Explorer.

  • List all commands:
> nrserver -help

Usage: ./nrserver [options]

-run [--dbroot <DBROOT>]]



-setport <PORT>



-adduser <USERNAME> <PASSWORD> [admin|user]

-setpassword <USERNAME> <NEW PASSWORD>

-setrole <USERNAME> [admin|user]

-enableuser <USERNAME>

-disableuser <USERNAME>

-deleteuser <USERNAME>


-deletecomputer COMPUTERNAME


-activateproduct <PRODUCT KEY>