> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/op5705xg/supplementary-operations/access-the-simulator-remotely-via-an-ssh-client.md).

# Access the Simulator Remotely via an SSH Client

You can use an [**SSH**](#user-content-fn-1)[^1] **client** to remotely and securely access your simulator from a computer on the same network.

In this **example** we will use **MobaXterm** SSH client but **you may use any other SSH client of your choice**. MobaXterm is not an OPAL-RT product, nor is it supported by OPAL-RT. It should be used according to the end-user license agreement of [Mobatek](https://mobaxterm.mobatek.net/).

{% stepper %}
{% step %}

## Download MobaXterm

1. On **your computer**, using an **internet browser**, go to MobaTek’s MobaXterm website: [**https://mobaxterm.mobatek.net/**](https://mobaxterm.mobatek.net/)
2. **Click** the **Download** section
3. **Select** the free **Home Edition** version of **MobaXterm** and click **Download now**
4. **Select** the **Portable edition** (this is the edition used on this page) or the **Installer edition** of **MobaXterm Home Edition**
5. **Save** the file to a **known location** on your **computer**
   {% endstep %}

{% step %}

## Install MobaXterm <a href="#install" id="install"></a>

1. On **your computer**, go to the folder (directory) **where you downloaded MobaXterm**.
2. **Extract** the content of the **zip file**, for example **MobaXterm\_Portable**\_v23.&#x34;**.zip** (the version number may be different).
3. **Double-click** the **extracted executable of MobaXterm**, for example **MobaXterm\_Portable**\_v23.&#x34;**.exe** (the version number may be different).

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/LVXXW35i38o8lm5O3I9V" alt="" width="265"><figcaption></figcaption></figure>

4. MobaXterm starts.

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/bbRMCfLM8FIIH4eAtOGS" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## &#x20;Configure MobaXterm

1. Click on **Session**.
2. Click on **SSH**.
3. Input the **simulator's IP address** in the **Remote host** field.
   * At delivery, the default simulator [**IP address**](#user-content-fn-2)[^2] is **indicated** on the **front panel** of your **simulator**.
   * It is also written in the **System Description Document** delivered with your system.
   * Most likely, the simulator IP address has been changed to integrate in your local network.
     * Check with your **IT department** for the IP address or
     * Check the section entitled “**Check the current IP address**” in the **Get Started > Set Up the simulator's IP Address** procedure above.
     * For **older systems** running **Red Hat OS**, **expand the section below to see the procedure to retrieve the IP address.**

<details>

<summary>Get the Target's IP Address Using the Red Hat OS Graphical Interface</summary>

* Plug a **monitor** into the **VGA port** at the rear of the simulator.
* Plus a **keyboard** and a **mouse** into **USB ports** at the back of the simulator.
* **Start the target** and **log in** using your **credentials**.
  * Username: **root**
  * Password: Refer to the <mark style="background-color:$primary;">System Description Document</mark> provided with your system in a binder, on a CD-ROM, or on a USB key.
* Click on **Applications >** **Accessories** > **Terminal**

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/9rZFnB4GZTO6YL1sMk8h" alt="" width="320"><figcaption></figcaption></figure>

* The **terminal window opens**.
* At the prompt **\[root\@RTServer ⁓]#**, type the Linux command in **lower case**.\
  \
  `ip a`

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/RcM39DlwrQeZoITNWfWt" alt="" width="499"><figcaption></figcaption></figure>

* In the paragraph beginning with **eth0,** check for the **string of numbers** after the word “**inet**” and **write down the string before the slash (“/”)**.\
  This is the **IP address** you will need to enter in **MobaXterm** to connect remotely to the target.
* In the **example**, the IP address is 10.64.109.235. **Your IP address will likely be different**.

</details>

4. Check **Specify username** and input **root** (lower case).
5. Click **OK**.

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/aSjqplxIsqwG4jDfdFon" alt=""><figcaption></figcaption></figure>

If it’s the **first time you use MobaXterm to connect to the simulator, you may be asked by Windows Defender Firewall** to **allow access to the network**. Click on **Allow the access**.

<details>

<summary>Click to view the screen shot</summary>

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/c7y3wgQ37T4ipTcPs1cy" alt="" width="563"><figcaption></figcaption></figure>

</details>

* If it's the **first time you use MobaXterm to connect to the simulator**, click “**Accept**” **to connect to the server** (your simulator), because, obviously, you trust it !

<details>

<summary>Click to view the screen shot</summary>

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/PRdlfWHuB1Wzz9mBbtbJ" alt="" width="563"><figcaption></figcaption></figure>

</details>

* MobaXterm will ask for a password. Input **your password** or the **default passwords**. For the **default password**, see the **Quick Start Guide** accompanying the **USB key**.

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/qoRCmK5ZaW6nhAZ9b6zo" alt=""><figcaption></figcaption></figure>

* If you're asked to **save the password**, answer **Yes**, but it doesn’t matter since the OPAL-RTLinux password will be different.

<details>

<summary>Click to view the screen shot</summary>

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/cGh2mVgldhOk6dkdkKDM" alt="" width="563"><figcaption></figcaption></figure>

</details>

* If asked, **you can create** a **master password** for MobaXterm, **it’s up to you**.

<details>

<summary>Click to view the screen shot</summary>

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/SQ9QEcdcJJ04mNmDwjLR" alt="" width="375"><figcaption></figcaption></figure>

</details>

You are now **logged in** to the simulator.

<div data-with-frame="true"><figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/cMkrirAXr5mrE5gYd7ek" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Use MobaXterm

MobaXterm is now configured, and **you are logged in remotely** to the simulator in terminal mode.

If you **lose connection with the simulator** at any time for any reason, just **press “R”** to **restart the session** as shown on the MobaXterm screen.

You can also **click on the simulator IP address** in the left pane.

<figure><img src="broken://spaces/7LhLoEldIvunS3fxYxrx/files/wUqpYd8OMIeZOIyMunf9" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

[^1]: Secure Shell

[^2]: The Internet Protocol (IP) address is in the form of a sequence of four blocks of numbers separated by a dot. Each block may have 1, 2 or 3 digits. The general scheme is 000.000.000.000.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/op5705xg/supplementary-operations/access-the-simulator-remotely-via-an-ssh-client.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
