> For the complete documentation index, see [llms.txt](https://whitepaper.starmech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.starmech.io/iv.-sta-key-purchase-and-run-sta-node/running-sta-node-client.md).

# Running STA-Node Client

Step-by-step instructions for running STA-Node Client, especially using VPS with Ubuntu OS for the first time

{% 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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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.