> For the complete documentation index, see [llms.txt](https://runyourai.gitbook.io/eng-runyourai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://runyourai.gitbook.io/eng-runyourai/register-machines/machine-registration-requirements.md).

# Machine Registration Requirements

## Machine Conditions

* Only physical servers with OS initialization and an installed SSH server can be registered.
* A physical server refers to a server equipped with CPU/MEM/GPU.
* The machine can be registered if it meets the following conditions.
* **GPU Driver must be pre-installed.**
* Please Check detailed conditions through the categories below.

<table><thead><tr><th width="222" align="center">category</th><th align="center">condition</th></tr></thead><tbody><tr><td align="center"><strong>Operating System(OS)</strong></td><td align="center">Ubuntu 20.04 LTS / Ubuntu 22.04 LTS</td></tr><tr><td align="center"><strong>CPU</strong></td><td align="center">At least <strong>8 cores</strong> <strong>or more</strong> are required</td></tr><tr><td align="center"><strong>GPU</strong></td><td align="center">At least <strong>NVIDIA GPU 30XX</strong> <strong>or higher</strong> is required</td></tr><tr><td align="center"><strong>RAM</strong></td><td align="center">More than <strong>32GB</strong></td></tr><tr><td align="center"><strong>Network</strong></td><td align="center"><p>At least 100 Mb/s Down / 50 Mb/s Up</p><p>-  Public IP Support</p></td></tr><tr><td align="center"><strong>Disk Capacity</strong></td><td align="center"><p><mark style="color:green;"><strong>1) OS Partition (no space provided to users)</strong></mark></p><p>-SSD or NVME</p><p>-At least 1 TB, recommended 2TB</p><p><mark style="color:purple;"><strong>2) Data Partition (space provided to users)</strong></mark></p><p>-Minimum 500MB, recommended 1TB</p><p>-Configured with LVM format</p><ul><li><strong>The actual space provided to users is 70% of the total machine capacity provided.</strong> <br><mark style="background-color:yellow;">(Example)</mark> if a machine with a total capacity of 2TB (1TB OS + 1TB Data) is provided, users can use 700GB of temporary space.</li><li><strong>Additionally, if the machine has multiple GPUs and is partitioned, </strong><mark style="color:red;"><strong>divide the capacity</strong></mark> <mark style="color:red;"><strong>by the number of GPU partitions</strong></mark><strong> based on 70% of the total capacity.</strong></li><li>Disk speed test : hdparm -tv {device}</li></ul></td></tr><tr><td align="center"><strong>GPU Driver</strong></td><td align="center"><mark style="color:red;"><strong>Pre-installation is mandatory.</strong></mark></td></tr></tbody></table>

## Checking Conditions

The method to check machine conditions is as follows.

* **Public IP** :  `$ curl`[ `ifconfig.me`](http://ifconfig.me/)

&#x20;      Example of the results)[ 200.XXX.XXX.XXX](http://200.xxx.xxx.xxx)

* **Network speed** :  `$ ethtool [Network interface name]`

<figure><img src="/files/H6xan1FYMFYICCMqssMM" alt="" width="414"><figcaption><p>Example of the results) <strong>Network speed</strong></p></figcaption></figure>

* **GPU model** :  `$ nvidia-smi`

<figure><img src="/files/t1oOEhXoVeEy7zKDRsyX" alt="" width="452"><figcaption><p>Example of the results) <strong>GPU model</strong></p></figcaption></figure>

* **CPU model** :  - model name

  &#x20;                              `$ cat/proc/cpuinfo | grep "model name"`

  &#x20;                        \- number of cores

  &#x20;                               `$ cat/proc/cpuinfo | grep "process" | wc -l`

<figure><img src="/files/xLRMGtL2FMaTkxfiRi0q" alt="" width="452"><figcaption><p>Example of the results) <strong>CPU model</strong></p></figcaption></figure>

* **RAM capacity** :  `$ free -h`

<figure><img src="/files/RvMDKZtq88MElJWhR2P7" alt=""><figcaption><p>Example of the results) <strong>RAM capacity</strong></p></figcaption></figure>

* **OS information** :  `$ cat /etc/os-release`

<figure><img src="/files/hdMjnuLvVSC2VGGm5QdW" alt=""><figcaption><p>Example of the results) <strong>OS information</strong></p></figcaption></figure>

* **Disk capacity** :  `$ df -h`

<figure><img src="/files/YWDx7fgaG83zx3Y5sUYi" alt=""><figcaption><p>Example of the results) <strong>Disk capacity</strong></p></figcaption></figure>
