> For the complete documentation index, see [llms.txt](https://apool.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apool.gitbook.io/help/xmr-pool-tutorial/xmr-linux-mining-tutorial.md).

# Xmr Linux Mining Tutorial

**1.  Acquire sub-account**

In order to earn xmr, one must mine to a sub-account. Head over to <https://www.apool.top> to finish email registration.&#x20;

<figure><img src="/files/tT9kgth0KaHlV8TN7i2K" alt=""><figcaption></figcaption></figure>

Apool will allocate a sub-account automatically under your name.  Check out your sub-account name in 'My miners' page.

<figure><img src="/files/TX21aXMXhUaCd1FIpZOP" alt=""><figcaption></figcaption></figure>

&#x20;**2. Download the mining software**

* Download link：<https://github.com/apool-io/xmrminer/releases>

<figure><img src="/files/1OR5NigVAanNa1EszEtl" alt=""><figcaption></figcaption></figure>

* Extract the file with the comand：

```
tar zxf apoolminer_linux_xmr_v3.7.0.tar.gz
```

&#x20;**3. Modify the configuration file miner.conf and change the account to your own.**

<figure><img src="/files/JYOwG4IWTbDhMK5SeRM4" alt=""><figcaption></figcaption></figure>

**4.apoolminer miner.conf Parameter Description**

<table><thead><tr><th width="203">Param</th><th>Description</th></tr></thead><tbody><tr><td>algo=&#x3C;qubic/aleo></td><td>Specify algorithm, default configuration is qubic , <strong>Required</strong></td></tr><tr><td>account=&#x3C;string></td><td>Specify your sub-account(CP_xxx) in pool mining or Specify your wallet address in solo mining, <strong>Required</strong></td></tr><tr><td>pool=&#x3C;url:port></td><td>Specify the proxy address, <strong>Required in pool mining</strong></td></tr><tr><td>solo=&#x3C;url:port></td><td>Specify the proxy address, <strong>Required in solo mining</strong></td></tr><tr><td>worker=&#x3C;name></td><td>Specify the worker name. The name consists of numbers and letters and cannot exceed 15 characters in length</td></tr><tr><td>gpu=&#x3C;indexes></td><td>Specify the index of GPU. If you’re only running on specific GPUs, please spell out explicitly, example: gpu=0,1,2, If you run all GPUs, you don’t need to configure them.</td></tr><tr><td>thread=&#x3C;num></td><td>Specify the number of CPU thread [default: 0, use all threads]</td></tr><tr><td>cpu-off=&#x3C;true/false></td><td>If you don’t want to use CPU, please configure it to True.</td></tr><tr><td>gpu-off=&#x3C;true/false></td><td>If you don’t want to use GPU, please configure it to True.</td></tr><tr><td>xmr-gpu-off=&#x3C;true/false></td><td>If you don't want to use the GPU during XMR mining time, please set this option to True.</td></tr><tr><td>xmr-cpu-off=&#x3C;true/false></td><td>If you don't want to use the CPU during XMR mining time, please set this option to True.</td></tr><tr><td>xmr-thread=&#x3C;num></td><td>Number of CPU threads to use during XMR mining time</td></tr><tr><td>no-cpu-affinity = true</td><td>If the default configuration does not fully utilize the CPU for XMR mining, you can optimize performance by manually specifying the number of XMR threads.</td></tr></tbody></table>

**Configuration file example**

* Configuration files for mining with CPU only

<pre><code><strong>algo=mone
</strong>account=CP_XXX
pool=xmr.asia.apool.io:4334

worker = my_worker
#cpu-off = true
#thread = 4
gpu-off = true
#gpu = 0,1,2
</code></pre>

* Connect using 1GB pages mode

{% code fullWidth="false" %}

```
algo=mone
account=CP_XXX
pool=xmr.asia.apool.io:4334

#worker = my_worker
#cpu-off = true
#thread = 1
#gpu-off = true
#gpu = 0,1,2
#xmr-gpu-off = true
#xmr-cpu-off = true
#xmr-thread = 1
xmr-lgb-pages = true
#no-cpu-affinity = true
```

{% endcode %}

**5.Run and shutdown**

* #### Select the execution script according to your needs

- [ ] &#x20;<mark style="color:red;">Manually operated Start command</mark>

<figure><img src="/files/RCd8Tj1QiOITSH64mYtA" alt=""><figcaption></figcaption></figure>

* If you do not need to automatically upgrade apoolminer, you can execute the run.sh script

```
bash run.sh
```

**6.** View apoolminer log

```
tail -f xmr.log
```

<figure><img src="/files/RrlGUIfcInr8ed44R8Ip" alt=""><figcaption></figcaption></figure>

**7.**&#x73;hutdown apoolminer command

```
killall -9 apoolminer
```

**8. Watch the Statistics and earn Xmr on Apool**

<https://xmr.apool.io>
