Setting Up The App

Download and install the server
Have you downloaded the server yet?  You will need it to complete the configuration.

Download the client from the marketplace


Our Goal
The primary goal of the content on this page is to help you determine the correct information to configure the client and server for Companion Remote Desktop (CRD).  In particular, this will show you what to enter for the 3 fields outlined in red below.
2 confusing fields in the client application

1 confusing field in the server application


Basic Networking Knowledge
We know you are eager to use this app and we want to make the configuration process as simple as possible.  Some basic network knowledge will help make this task far easier.

Internal vs External Network
The words "Internal" and "External" network are often used to describe the properties of a given network.
In your home, you most likely have a single wireless router.  Anything that is connected to your router would be on your Internal Network.

What the typical internal network looks like
Whereas anything that is not directly connected to your router would be considered the External Network.  A good example of this would be when you're using the 3G connection on your phone or a WiFi connection from your local coffee shop, these are not connected to your router.
Anything not directly connected to your router is an external network

There are 2 ways to configure the CRD server based on whether you are connected on your internal or external network.

Configuring for Internal Access (Always do this first!)
This method is the easiest to configure and we strongly recommend configuring in this way first to make sure that everything is working.  Once you have successfully configured for internal access you can proceed to the more difficult external configuration.

When you configure for internal access, you will only be able to connect to the CRD server from within your internal network.  This means that if your phone is connected to 3G/4G or your coffee shop WiFi that this method will fail, you must be connected to WiFi on the same router that is connected to your PC.

The typical Internal Network configuration
Step 1 - Download and install the SWTOR Companion Remote Desktop Server.


Step 2 - Configure and start the server (The text below contains the same content as the video)
When you first launch SWTOR CRD, it will ask for administrative access.  Administrative access is required to allow the server to send mouse clicks to the SWTOR game window.  There are only two things to configure on the server, the port and the password.

Port
If you think of an IP address being like a telephone number for your PC, a port is like an extension.  Knowing a telephone number plus extension will let you reach a specific person.  In the same way, an IP address plus a port number lets you reach a specific application on your PC.  CRD needs a port number so that the client app knows how to reach it.

What port to choose?  You can choose anything in the range 1024 - 49151.  It does not matter which one you choose, the only requirement is that the port you choose cannot already be in use.  Do not worry though, if you accidentally choose a port that is in use then we will tell you to choose another one when you try to start the server.

For slightly advanced users, see this support thread on how to see all ports in use.

Password
The password is used to authenticate any mobile clients that are trying to access the server.  You will need to remember this password so that you can enter it on any devices using the SWTOR CRD app.

Unblock the firewall
Once you have entered the Port and Password, start the server.  The first time you do this, you will be prompted to unblock your firewall for the tortrade.exe process.  Be sure to select Unblock here.

Done
When finished with this step, you will have the following:
  • A port number will be chosen (required for client)
  • A password will be chosen (required for client)
  • The server will be running

Step 3 - Find the Internal IP address of your PC
Before we configure the client, we need to know the internal IP address of your PC.  The video below explains how to find the IP address on your PC.


CAUTION
If you've performed a search on google for "what's my ip address", you cannot use the IP address it gives you for this method.  Google is telling you your External IP address and for this method you need the internal  IP address.

Done
When finished with this step, you will have the following:
  • The Internal IP address of your PC (required for client)

Step 4 - Configuring the client (The text below contains the same content as the video)
If you have completed steps 2 and 3, you now have all the information you need to configure the client.


IP Address
The internal IP address of your PC.  This was found in step 3.

Port
The port on your PC that the CRD server is running on.  You selected this in step 2.

Password
The password you entered in step 2.

Step 5 - Using the client

Configuring SWTOR
For best results, you should run SWTOR in windowed mode at 1024x768 resolution.  Make sure that there aren't any windows on top of the SWTOR game client.

For a summary of the buttons and controls, please see the main app page.

Configuring for External Access

The method above explained how to configure CRD for use on your internal network.  Do not attempt configuring for External Access until you have successfully configured for Internal Access.

Why internal vs external?  The why is very simple to answer.  You want to use this app from your local coffee shop and from your 3G/4G connection, not just from your internal network.

To accomplish this we need to add a few extra steps to the above procedure, essentially we are replacing step 3 with the following.

Step 1 - Find your public IP address
This can be accomplished by searching for "what's my ip" in google.
Google will tell you your public ip address
Step 2 - Understand port forwarding
Port forwarding is confusing to most people, let's break down this mystery.

Routers
Somewhere in your house, you have a router that is connected to your DSL or cable modem.  The router assigns IP addresses to every device on your internal network.  Here is an example, the IP addresses are made-up and will be different on your network.

A fake example of what a typical internal network looks like
So in the picture above, the router has assigned an IP address of 192.168.1.10 to the PC along with other IP addresses to other devices on the network.  Also note that the router (actually the cable/dsl modem) has a public IP address.

You may wonder, how is the IP address chosen and does it ever change?  These are both excellent questions.  Routers use something called DHCP to assign IP addresses to devices on the network.  The IP addresses are assigned in numerical order based on the order that they are requested.

As an example, the router might assign addresses in the range 192.168.1.2 - 192.168.1.200.  If you turn the laptop on first, it will get an address of 192.168.1.2 because it is the first device to request an address.  This is slightly more complicated than I explain because every time an IP address is assigned you get a lease that lasts a certain period of time.

You can prevent your PC's IP address from changing by either adding a DHCP reservation for it in your router or assigning it a static IP address.  Not all routers allow you to make DHCP reservations and you'll want to read up on assigning a static IP address (or post in the forums).

Key points to remember (if the above made no sense)
  • The router assigns an IP address to your PC
  • The IP address of your PC can change between reboots (!!!)
  • Your router has a public IP address that may also change very time you reboot your modem (!!!)
Why Port forwarding is needed
Two things are needed for every request you make over the internet
  1. The IP address of your destination
  2. The port number of your destination
This is very similar to dialing a phone number and knowing the extension of the person you'd like to reach.

For these examples, let's pretend that the following data is true:
PC Internal IP: 192.168.1.2
SWTOR CRD Port: 8081
Public IP: 70.0.0.0

Scenario 1: On your internal network
In this scenario, the mobile device is on the internal network and can communicate directly with the PC on the specified port.
On your internal network, the router brokers this conversation successfully
Scenario 2: On the external network
In this scenario, the mobile device is on an external network.  Can you spot the error in the example?
What is wrong with this picture?  Oops, we've used the Internal IP instead of the External!
The problem with the above picture is that we tried using the Internal IP address of our PC.  This address has no meaning outside of our Internal Network.  To contact our router from outside the network we have to use the External IP address.  Let's do that.

Using the external IP immediately brings up another problem!
Which IP address should the router send the request to?
The problem is that the router doesn't really know where to send the request on the internal network.  Should it send it to the laptop, the PC, the television or the toaster?  This outlines the fundamental need for port forwarding.

Port Forwarding in a Nutshell
Port forwarding lets you configure your router to overcome the above limitation.

For instance, you can configure port 8081 on the router to forward to 192.168.1.2.
By forwarding port 8081 to 192.168.1.2, we can communicate from the outside world!

Step 3 - Forward a port on your router
Forwarding a port on your router is different for every brand, make and model.  We recommend visiting http://portforward.com/ for detailed instructions on how to forward a port for your specific router.  Also did we mention that our Support Forums are pretty kick-ass?  Really, we don't bite.

Step 4 - Configure the mobile app
Once you have forwarded a port, you need to configure the client application to use:
  • Your external IP address (found in step 1)
  • The forwarded port number (set in step 3)
Need Help?
Do you need more assistance configuring the application?  Please post a question on our forums.