lotus/documentation/en/hardware-mining.md

# Protocol Labs Standard Testing Configuration

> This documentation page describes the standard testing configuration the Protocol Labs team has used to test **Lotus Storage Miner**s on Lotus. There is no guarantee this testing configuration will be suitable for Filecoin storage mining at MainNet launch. If you need to buy new hardware to join the Filecoin TestNet, we recommend to buy no more hardware than you require for testing. To learn more please read this [Protocol Labs Standard Testing Configuration post](https://filecoin.io/blog/filecoin-testnet-mining/).

**Sector sizes** and **minimum pledged storage** required to mine blocks are two very important Filecoin TestNet parameters that impact hardware decisions. We will continue to refine all parameters during TestNet. 

BECAUSE OF THIS, OUR STANDARD TESTING CONFIGURATION FOR FILECOIN MAINNET CAN AND WILL CHANGE. YOU HAVE BEEN WARNED.

## Example configuration

The setup below is a minimal example for sealing 32 GiB sectors on Lotus:

* 2 TB of hard drive space.
* 8 core CPU
* 128 GiB of RAM

## TestNet discoveries

* If you only have 128GiB of ram, enabling 256GB of **NVMe** swap on an SSD will help you avoid out-of-memory issues while mining.

## Benchmarked GPUs

GPUs are a must for getting **block rewards**. Here are a few that have been confirmed to generate **SNARKs** quickly enough to successfully mine blocks on the Lotus TestNet.

* GeForce RTX 2080 Ti
* GeForce RTX 2080 SUPER
* GeForce RTX 2080
* GeForce GTX 1080 Ti
* GeForce GTX 1080
* GeForce GTX 1060

## Testing other GPUs

If you want to test a GPU that is not explicitly supported, you can use the following configuration flag:

```sh
BELLMAN_CUSTOM_GPU="<NAME>:<NUMBER_OF_CORES>"
```

Here is an example of trying a GeForce GTX 1660 ti with 1536 cores.

```sh
BELLMAN_CUSTOM_GPU="GeForce GTX 1660 Ti:1536"
```

To get the number of cores for your GPU, you will need to check your card’s specifications.

## Benchmarking

Here is a [benchmarking tool](https://github.com/filecoin-project/lotus/tree/testnet-staging/cmd/lotus-bench) and a [GitHub issue thread](https://github.com/filecoin-project/lotus/issues/694) for those who wish to experiment with and contribute hardware setups for the **Filecoin TestNet**.
-												documentation: updates terms for hardware docs

											
										
										
											2019-12-11 15:56:48 +00:00
+								# Protocol Labs Standard Testing Configuration
-												documentation: current state of public documentation from https://docs.lotu.sh

											
										
										
											2019-12-06 15:26:03 +00:00
-												documentation: updates terms for hardware docs

											
										
										
											2019-12-11 15:56:48 +00:00
+								> This documentation page describes the standard testing configuration the Protocol Labs team has used to test **Lotus Storage Miner**s on Lotus. There is no guarantee this testing configuration will be suitable for Filecoin storage mining at MainNet launch. If you need to buy new hardware to join the Filecoin TestNet, we recommend to buy no more hardware than you require for testing. To learn more please read this [Protocol Labs Standard Testing Configuration post](https://filecoin.io/blog/filecoin-testnet-mining/).
-												documentation: current state of public documentation from https://docs.lotu.sh

											
										
										
											2019-12-06 15:26:03 +00:00
-												documentation: updates from the testing session

											
										
										
											2019-12-11 01:50:13 +00:00
+								**Sector sizes** and **minimum pledged storage** required to mine blocks are two very important Filecoin TestNet parameters that impact hardware decisions. We will continue to refine all parameters during TestNet.
 								BECAUSE OF THIS, OUR STANDARD TESTING CONFIGURATION FOR FILECOIN MAINNET CAN AND WILL CHANGE. YOU HAVE BEEN WARNED.
 								## Example configuration
 								The setup below is a minimal example for sealing 32 GiB sectors on Lotus:
-												documentation: testnet update

											
										
										
											2019-12-11 15:38:04 +00:00
+								* 2 TB of hard drive space.
-												documentation: mining updates from recent TestNet updates

											
										
										
											2019-12-11 12:29:48 +00:00
+								* 8 core CPU
-												documentation: testnet update

											
										
										
											2019-12-11 15:38:04 +00:00
+								* 128 GiB of RAM
-												documentation: mining updates from recent TestNet updates

											
										
										
											2019-12-11 12:29:48 +00:00
 								## TestNet discoveries
-												documentation: testnet update

											
										
										
											2019-12-11 15:38:04 +00:00
+								* If you only have 128GiB of ram, enabling 256GB of **NVMe** swap on an SSD will help you avoid out-of-memory issues while mining.
-												documentation: updates from the testing session

											
										
										
											2019-12-11 01:50:13 +00:00
 								## Benchmarked GPUs
-												documentation: testnet update

											
										
										
											2019-12-11 15:38:04 +00:00
+								GPUs are a must for getting **block rewards**. Here are a few that have been confirmed to generate **SNARKs** quickly enough to successfully mine blocks on the Lotus TestNet.
-												documentation: updates from the testing session

											
										
										
											2019-12-11 01:50:13 +00:00
 								* GeForce RTX 2080 Ti
 								* GeForce RTX 2080 SUPER
 								* GeForce RTX 2080
 								* GeForce GTX 1080 Ti
 								* GeForce GTX 1080
 								* GeForce GTX 1060
 								## Testing other GPUs
-												documentation: testnet update

											
										
										
											2019-12-11 15:38:04 +00:00
+								If you want to test a GPU that is not explicitly supported, you can use the following configuration flag:
-												documentation: updates from the testing session

											
										
										
											2019-12-11 01:50:13 +00:00
 								```sh
 								BELLMAN_CUSTOM_GPU="<NAME>:<NUMBER_OF_CORES>"
 								```
 								Here is an example of trying a GeForce GTX 1660 ti with 1536 cores.
 								```sh
 								BELLMAN_CUSTOM_GPU="GeForce GTX 1660 Ti:1536"
 								```
-												documentation: testnet update

											
										
										
											2019-12-11 15:38:04 +00:00
+								To get the number of cores for your GPU, you will need to check your card’s specifications.
-												documentation: updates from the testing session

											
										
										
											2019-12-11 01:50:13 +00:00
 								## Benchmarking
 								Here is a [benchmarking tool](https://github.com/filecoin-project/lotus/tree/testnet-staging/cmd/lotus-bench) and a [GitHub issue thread](https://github.com/filecoin-project/lotus/issues/694) for those who wish to experiment with and contribute hardware setups for the **Filecoin TestNet**.