> For the complete documentation index, see [llms.txt](https://docs.ccv.brown.edu/oscar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ccv.brown.edu/oscar/debugging/arm-forge/configuring-remote-launch.md).

# Configuring Remote Launch

## Configuring Remote Launch from the client

You will need to configure remote launch for Oscar

1. Open the client on your machine
2. Click 'Remote Launch' -> Configure
3. Enter the following details in each field:
   * **Host Name**: `username@ssh.ccv.brown.edu`
   * **Remote Installation Directory**: Add the path to the forge executable here. You can obtain this by loading the `linaro-forge` module on Oscar and running the command `which forge`
   * Check the **Proxy through login node** checkbox
4. Click the **Test Remote Launch** button
5. You should enter the password used for Oscar when prompted.

If successful you should see the message `Remote Launch test completed successfully`

![Remote launch settings for Oscar. The fields are filled as per instructions in step 3](https://4272811953-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWJ6pKCQH6l3rl9IQa%2F-LlY3OYzPyKqH2oLag9_%2F-LlY4VK2R1tFZLyboM7m%2FScreen%20Shot%202019-08-05%20at%202.41.01%20PM.png?alt=media\&token=c34b54f3-d873-4ce7-8c07-f576b0a7c8c9)

{% hint style="info" %}
If you have a mismatch between your client version on the version of Forge on Oscar you will see an error message. To fix this make sure you are using compatible client and remote versions
{% endhint %}

![Popup box warning to ensure the compatibility between client and remote versions](https://4272811953-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWJ6pKCQH6l3rl9IQa%2F-LlY4b5Ze7EtSBZ7IS6O%2F-LlY5ZiO15O2Rvs_Sz2T%2FScreen%20Shot%202019-08-05%20at%202.45.28%20PM.png?alt=media\&token=507275c6-1f63-423b-8873-10140fb85fb0)

{% hint style="info" %}
Once you are connected you will see a Licence checked out and "Connected to <username@ssh.ccv.brown.edu>' on the client.
{% endhint %}

![Arm Forge Launch Screen](https://4272811953-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWJ6pKCQH6l3rl9IQa%2F-LlY4b5Ze7EtSBZ7IS6O%2F-LlY6LZ1ZlA3I6Q6Ihhn%2FScreen%20Shot%202019-08-05%20at%202.48.46%20PM.png?alt=media\&token=37d2f3d0-b1fe-47fd-9343-1efc8d070cba)
