# Linux Automatic Update Tutorial

**1.  Acquire sub-account**

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

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

<figure><img src="https://173695165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhcaIJhxZbNgQ58zWSXWs%2Fuploads%2F6wlzyyOLADp1FfwOFP5n%2F%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20240410112842.png?alt=media&#x26;token=fac31930-c33c-4923-8d66-10bda5e427e6" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://173695165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhcaIJhxZbNgQ58zWSXWs%2Fuploads%2FcyzEFQacOuArA9q3JBEU%2Fimage.png?alt=media&#x26;token=8d18b7f9-fe83-4382-960f-745c6487249b" alt=""><figcaption></figcaption></figure>

* Extract the file with the comand：

```
tar zxf apoolminer_linux_autoupdate_v3.5.0.tar.gz
```

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

<figure><img src="https://173695165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhcaIJhxZbNgQ58zWSXWs%2Fuploads%2FrZiWRnHHaQAFV2X2uTFn%2Fimage.png?alt=media&#x26;token=b87c664c-d764-4b77-a13b-806b493acb99" 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></tbody></table>

**Configuration file example**

* Configuration files for mining with GPU and CPU (Recommended mining configuration for all resources)

  ```
  algo=qubic
  account=my_sub_account
  pool=qubic.asia.apool.io:4334
  ```
* Configuration files for mining with GPU only

  ```
  algo=qubic
  account=my_sub_account
  pool=qubic.asia.apool.io:4334
  cpu-off=true
  ```
* Configuration files for mining with CPU only

  ```
  algo=qubic
  account=my_sub_account
  pool=qubic.asia.apool.io:4334
  gpu-off=true
  ```
* Configuration files for mining with CPU and specify the number of CPU thread

  <pre><code><strong>algo=qubic
  </strong>account=my_sub_account
  pool=qubic.asia.apool.io:4334
  gpu-off=true
  thread=8
  </code></pre>
* Connect using SSL/TLS encryption

  ```
  algo=qubic
  account=my_sub_account
  pool=qubic.asia.apool.io:4334
  gpu-off=true
  ```

**5.Run and shutdown**

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

  * [ ] &#x20;<mark style="color:red;">Autoupgrade Start command</mark>

<figure><img src="https://173695165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhcaIJhxZbNgQ58zWSXWs%2Fuploads%2F2OwuXIfa1ycQglq9ctDB%2Fimage.png?alt=media&#x26;token=e310658c-f554-4cca-94a0-679b1f10530e" alt=""><figcaption><p><mark style="color:red;">Autoupgrade Start command</mark></p></figcaption></figure>

* If you want to run an automatic upgrade of apoolminer, you can execute the upgrade\_and\_run.sh script

```
nohup bash upgrade_and_run.sh > nohup.out 2>&1 &
```

&#x20;

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

<figure><img src="https://173695165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhcaIJhxZbNgQ58zWSXWs%2Fuploads%2FyAbk4a0NkMg7oAwKsXpX%2Fimage.png?alt=media&#x26;token=c0381b1c-e646-4233-8072-9a17789d2c1e" alt=""><figcaption><p><mark style="color:red;">Manually operated Start command</mark></p></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 qubic.log
```

<figure><img src="https://173695165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhcaIJhxZbNgQ58zWSXWs%2Fuploads%2FwbSsaCdU0eAawGKL9KcH%2Fimage.png?alt=media&#x26;token=e32e8d1f-3ff5-4e5f-8da6-5328199a1e12" alt=""><figcaption></figcaption></figure>

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

```
killall -9 apoolminer
```

&#x20;

**8.**&#x73;hutdown autoupgrade script

If you are running an automatic upgrade script, use the following command to shutdown and it will no longer be upgraded.

```
for i in $(ps aux|grep "upgrade_and_run"|grep -v grep |awk '{print $2}'); do sudo kill -9 $i; done
```

**9. Watch the Statistics and earn QU's on Apool**

<https://www.apool.io/myMiner>
