Skip to main content

Gminer

CPU miner notice

Gminer is a CPU miner. CPU mining is only practical on test networks; on mainnet it is not competitive. Use GPU or scrypt ASIC for mainnet.

This guide walks you through downloading, configuring, and running Gminer. By the end, you'll have a working CPU miner connected to a Flokicoin testnet pool.

Download and Installation​

Download the latest miner release:

  • Go to the releases page.
  • Download the version suitable for your operating system and architecture.

gminer is available on:

  • Mac
  • Linux
  • Windows

Install gminer on Mac​

Mac with apple silicon​

Download gminer-darwin-arm64-v0.1.5-beta.tar.gz then extract the archive:

tar -xvf gminer-darwin-arm64-v0.1.5-beta.tar.gz
chmod +x gminer

Mac with Intel chip​

Download gminer-darwin-amd64-v0.1.5-beta.tar.gz then extract the archive:

tar -xvf gminer-darwin-amd64-v0.1.5-beta.tar.gz
chmod +x gminer

 

Install on Linux​

Download gminer-linux-amd64-v0.1.5-beta.tar.gz then extract the archive:

tar -xvf gminer-linux-amd64-v0.1.5-beta.tar.gz
chmod +x gminer

 

Install on Windows​

Download gminer-windows-386-v0.1.5-beta.zip then extract the archive.

 

Configuration​

Before running the miner, ensure a configuration file (gminer.conf) exists in the same directory as the gminer executable file. You can download a sample config file from grpc-miner repository.

You need to update the following parameters:

Mining pool endpoint

pool = solo.example.com:5055

Find below the list of community-known pools:

AuthorDev feePoolPort
myf-gpool.myfloki.com5055

You’re encouraged to create your own pool, set a developer fee if desired, and share it with the Flokicoin community in #Mining channel on Discord.

Mining addresses

You can specify one or more mining addresses:

miningaddr = YOUR_FLOKICOIN_ADDRESS_1
miningaddr = YOUR_FLOKICOIN_ADDRESS_2

Threads

Set the number of CPU threads to dedicate for mining. By default, if unspecified, gminer uses all available threads.

threads = 16

 

How to run​

On Mac and Linux: Navigate to the directory containing the extracted binary and run:

./gminer
On macOS, authorize gminer by navigating to System Settings → Privacy & Security → General and click “Open Anyway” to trust the developer.

On Windows: Navigate to the directory containing the extracted gminer.exe and double-click it or run it from the command line:

gminer.exe
If Windows Defender or another antivirus blocks gminer.exe, you might need to explicitly allow or unblock it.

 

Monitoring​

You can monitor the mining performance and status directly in the terminal. The information includes:

  • Hashrate
  • Blocks found
  • Possible errors

 

Troubleshooting and recommendations​

  • Verify that your gminer.conf file is in the correct directory and that pool addresses, mining addresses, and ports match your intended configuration.
  • On macOS, authorize gminer in System Settings and mark the developer as trusted.
  • Verify the server address and port in gminer.conf.
  • Ensure your internet connection is active.
  • Regularly update the gminer from the releases page.

 

Support​

For further assistance, join the #mining channel in the Flokicoin Discord Community.