# Running STA-Node Client

{% embed url="<https://youtu.be/7H8i5KosJFM>" %}

STA-Node Client currently has 2 versions for Windows and Linux. You can launch the application right on your computer. To ensure compatibility, we recommend the following:

* Windows OS: Windows 7 or later, do not use Windows Server
* Linux OS: Ubuntu 20.04 LTS or later

**Download STA-Node Client:**&#x20;

* Ubuntu: <https://download.starmech.io/ubuntu/latest>
* Windows: <https://download.starmech.io/windows/latest>

## Minimum Hardware Requirements

2 GB RAM\
1 CPU Cores\
40 GB Disk Space\
x86/X64 Processor\
Stable Internet Connection

## Ubuntu

### Register VPS

We recommend to use VPS from well-known services such as Vultr, DigitalOcean to ensure stability.

The operating system we recommend is: **Ubuntu 20.04 LTS x64.**

### Login VPS with SSH

Docs: <https://docs.vultr.com/connect-to-a-server-using-an-ssh-key>. If you bought a server from another provider, the steps are basically the same.

`In the process of executing commands, if any command responds "Abort!", use the up arrow button on the keyboard to quickly re-enter the previous command (which has not been completed yet), then execute again.`

### Setup Ubuntu server

`sudo apt-get update`

`sudo apt-get upgrade`

### Create Sudo user

*(for example: new user is ‘stavax’)*

`adduser stavax`

`sudo usermod -aG sudo stavax`

### Install GUI for first-time users of Linux/Ubuntu

`sudo apt install lightdm`

<figure><img src="https://lh7-us.googleusercontent.com/dQeHBzWEWR8Q4e-X8P3HbID1Zz5AiwydxaPQjfQ_YkrSXbR5jWHHnsriIti7Yy_RCNJW2D2drgg2XvEKMSJmeUhJ7LE_jkmHiKzImSPrQ3I3sT7Li-BH9ebbnQ7JU_o1qNaQPurd_qS1wCVYI29hldM" alt=""><figcaption><p><em>Choose lightdm as default display manager at the congifuring lightdm screen</em></p></figcaption></figure>

`sudo systemctl start lightdm`

`sudo apt-get install ubuntu-desktop`

### Install Remote Desktop with xrdp

*Instead of using Console Viewer in some VPS providers, you now can use Remote Desktop.*

`sudo apt-get install xrdp`

`sudo sed -i 's/3389/53579/g' /etc/xrdp/xrdp.ini`

`sudo sed -i 's/#Port 22/Port 53572/g' /etc/ssh/sshd_config`

`sudo ufw allow 53572 && sudo ufw allow 53579 && sudo ufw enable && sudo ufw status numbered`

`sudo reboot`

### Connect to VPS with Remote Desktop

Use remote desktop application to connect to your VPS. Your server IP for remote connection is:

```
<server-ip>:53579
```

<figure><img src="https://3526794043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAtBoiI3CnDJEhUKxmTLY%2Fuploads%2F061QLb5SjwDdMOfazNek%2Fimage.png?alt=media&#x26;token=485ce5f3-26c7-4e70-bc9e-4a0aa18ea79c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3526794043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAtBoiI3CnDJEhUKxmTLY%2Fuploads%2F3ePsWjEiv5I2CoOXNsLg%2Fimage.png?alt=media&#x26;token=7286215f-d791-4d4c-9613-7e1f1cb0f74d" alt=""><figcaption><p>Enter your username and password you have created above</p></figcaption></figure>

### Download and Install STA-Node Client

Open Firefox browser and download STA-Node Client on <https://starmech.io/>

Right click on downloaded file, choose Properties

<figure><img src="https://3526794043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAtBoiI3CnDJEhUKxmTLY%2Fuploads%2FIrxa615QQtQ7blw5Oak9%2Fimage.png?alt=media&#x26;token=0f00f10f-4adc-4fe5-9717-9b555317ea8d" alt=""><figcaption><p>Choose Properties</p></figcaption></figure>

Switch to **Permissions** tab, tick on the checkbox **Allow executing file as program**

<figure><img src="https://3526794043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAtBoiI3CnDJEhUKxmTLY%2Fuploads%2FOzYiKVKe773ETOt3gcHX%2Fimage.png?alt=media&#x26;token=a54b20a5-61c2-4aae-b5c0-49ea7f84cc75" alt=""><figcaption><p>Choose Permissions > Tick on Allow executing file as program</p></figcaption></figure>

Right click on the file again, choose **Run**

<figure><img src="https://3526794043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAtBoiI3CnDJEhUKxmTLY%2Fuploads%2FeUMP6WadluuOWPwUOt9A%2Fimage.png?alt=media&#x26;token=b82adbd4-b0fc-4d52-a80d-7796a7ff1443" alt=""><figcaption><p>Now you can login to your STA-Node Client</p></figcaption></figure>

* Select "Connect Wallet" and then confirm the connection within your wallet.&#x20;
* On a mobile device, employ Metamask to establish a connection between STA-Node and Wallet Connect.&#x20;
* Once the wallet is successfully linked, the main screen will display all your nodes and their current statuses.

<figure><img src="https://3526794043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAtBoiI3CnDJEhUKxmTLY%2Fuploads%2FzBEKf6rqXiwxvrZ63wiP%2FNode%20run.png?alt=media&#x26;token=09b464eb-223c-4342-bc9c-a78868770163" alt=""><figcaption></figcaption></figure>

Now you have successfully completed the installation of STA-Node. Observe as $ndSTA flows into your pocket!

## Windows

With Windows OS, you just need to download the exe file, install and run like other applications.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://whitepaper.starmech.io/iv.-sta-key-purchase-and-run-sta-node/running-sta-node-client.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.