Join us in Outworldz at or follow us:

[Table of Contents]

Troubleshooting Step by Step

Reset your router by cycling the router power. Yes, I know it sound stupid, but clears out old uPNP settings that are messing with your port forwards.

Make sure Opensim is working

Go to Settings -> Expert mode, click the DNS button at top left, and enter ''. Then restart the grid, and use as the grid in the viewers "Add Grid" menu.

You should be able to see the Systems admin web page with a viewer by clicking the above link.

Open up your viewer. Now add the grid to the viewer. You should now be able to log in on the Server from the Server.

You should see the Welcome region spit out a lot of text as you log in. If this fails, it is not your network, router, or loopback. You probably forgot the password. You can rest it it with the command 'reset user password' in the Robust screen.

How to get on the Hypergrid

You must be able to access yoru PC by the PUBLIC IP address on the Internet side. The routers you are using almost certainly block this by default. So you have to program the router to allow the traffic in.

Step 1) Get your LAN IP

Get your PC LAN IP address by going to a DOS prompt and typing 'ipconfig'.


In the above photo, my IP was Yours is likely to be in the range 192.168.*.*, but it could also be a 10.0.*.* number.

Step 2) Check that your IP address is working

Use a web browser and go to http://LAN-IP:8002. Use your actual IP address here. It will be something like No, not Use your IPCONFIG IP address. You must be able to see the Grid Login Page. If not, check the IP address again with IPCONFIG. Re-try (it should work).  If this does not work, you have a firewall issue on the server PC.

Try to fix it by turning off your PC firewall, and disabling any anti-virus. Once it is working, turn each thing back on, one at a time, and when it fails to show the web page, then add an exception to the ports to that application until it works and your system is secure.

When this passes, go to Step 3.

Step 3) Port Forwards

Add Port forwarding to your router.

Port forwarding is necessary in this application if you want to be able to access the Hypergrid. If your router does not support it, you can access your routers firewall menu and add port forwarding.

Here is a list of routers and how to program Port Forwarding. Additional Information on Port Forwarding can be found at

Please note that if you are using consumer network hardware, you will also need a router that supports NAT loopback. See Loopback if you do not have a working  loopback router, and want give external users access.

For my Linksys, it looks like this:

LinkSys Port Frward

The Shoutcast setting is used when you are running the Icecast/Shoutcast server.

Which ports? You need to Port-Forward 8001, 8002, and 8004-8010 (or higher, I usually open up to 8050) to have room for expansion. Don't do 8003 for security reasons. These can be done in ranges, like 8001-8002 and 8004-8010. The latter ones are for regions - you need one port per region, so this would let you have 7 regions. Add more if you want - nothing wrong with opening up to 8020 or 8030 or so. In the above photo, I have opened up ports 8004 through 8005.

They need to be open for both TCP and UDP. Your router will have a button or a pulldown to select UDP, TCP, or both.

How do I know this worked? You can tell if it worked by starting Opensimulator, and then use a web browser to go to, and enter 8002 when Opensimulator is running. If that works, the ports are fine.

Step 4) Test Port 8002.

Go to  Add port 8002 to it, and run the test. It must show SUCCESS. If it fails, fix the router to port-forward to the PC's LAN IP address ( the one with 192 at the beginning) . Be sure to open enough ports, typically 8001-8002 and 8004-8050 so you have room for many regions. Ports need to be set to open for both TCP and UDP. If you are doing this all in order, the only thing that can stop this from working is the router. Since step 2 worked, it is not the PC, firewall on the PC, or anti-virus.

You can read how to do this for your router at

If this passes, go to Step 5.

Step 5) Test the Public IP

Copy or write down the IP address by This is your PUBLIC IP.

Use web browser to navigate to your WAN (Internet) address of http://<PUBLIC IP>:8002. You should be able to see the Grid Login Page.

If this passes, go to Step 6.

Step 6. Get a DNS name

We need a DNS name. Up until now you have been using an IP address for your grid instead of a DNS name, but now you need a name.

Go to the Settings panel, and in DNS name, add a name such as Press save. It will take 15 seconds or so to save. For this example,  I will pretend you are using a <YOURNAME>

You can use any simple name (no spaces), and optionally a dash (-) , to register your world. Then press "Test DNS". It should tell you your IP address is the same as your PUBLICIP.

Step 7) Test the DNS name

Open up the web browser and load http://<YOURNAME> Use whatever name you chose. You must be able to see the Login Page. If this passes, go to Step 7.

If this fails, you have a loopback problem. You will only be able to run the viewer on the same PC as the server.

Step 8) Add Grid to the viewer

Now add the grid name you chose http://<YOURNAME> to the viewer. It should fill in the grid with the details from the XML page.

SStep 9) Log in

You should now be able to log in on the Server from the Server./p>

The second part that has to work is loopback - either your router supports it, or not. You can immediately tell if your loopback works after running the above tests. You use your web browser to navigate to http://(YOUR PUBLIC IP):8002. Mine was Of course, your IP address will be different than shown here, so use whatever CanYouSeeme shows you. If the system is working, you get a web page.

If it works, go the the Settings->Expert Settings menu, and click the DNS Name field.

Click it and you get a pop up, where you can enter your desired DNS name

DNS name

Either click Next Name until you see one you like, and press Save, or type a name like '". The name will not work with spaces, and only characters A to Z and 0-9 plus a dash are allowed. It is lower case.  Then click Save, and restart Opensim.

You use your web browser to navigate to http://(YOUR NEW NAME):8002, such as "". If you get the web page, use that same name to add the Grid Settings to your viewer, and you should be set to go.

Back to the Best Free Tools in Second Life and OpenSim.