Getting Started Mac Guide 🍎 🐢

This guide is for Mac users who want to get started with the TurtleCoin blockchain and wallet along with the xmr-stak miner. Suggestions for improving this document are welcome and can be submitted in the "Issues" section of this repository.

Show your support for this guide by sending some shells to:

TRTLuxbuW9uZfhAgmLpK8mfisSScfp325GiTHbD2he3eFHcrxbaHxaQRNJcnA42pbSejGaLEcCvGCeiHDr1Frz8YC71hbWUEVYa

Getting Started

The first thing to do is install TurtleCoin on your Mac.

Go to the main TurtleCoin website at turtlecoin.lol to download the latest Mac build. These are CLI files used to sync to the TurtleCoin blockchain and create a wallet.
Make a folder on your desktop called "TurtleCoin" and unzip the contents of the downloaded zip file into this folder.

cd ~/Desktop
mkdir TurtleCoin

Sync the Blockchain

Now that you have the latest CLI files in your TurtleCoin folder, the next steps are to sync the blockchain to your computer.

Go to the TurleCoin folder and run the syncing program to start syncing with the blockchain. Run the following commands in a terminal window:

cd ~/Desktop/TurtleCoin
./TurtleCoind

While the blockchain is downloading to your computer, various files will be created in the ~/.TurtleCoin folder. This folder is located in the user's home directory, it is not the same folder you created earlier on the desktop. Since the syncing process can take several hours, go ahead and exit the program by entering the exit command in the terminal.

exit

To speed things up, you can download a recent copy of the blockchain by following the instructions for Mac and Linux at HowToBootstrapBlockchain.
After you download the blockchain from Step 3, start the syncing process again from within the ~/Desktop/TurtleCoin folder.

cd ~/Desktop/TurtleCoin
./TurtleCoind

Wait until the sync is complete. The completion will be indicated in the terminal window with green text saying SYNCHRONIZED OK.

Wallet

Now that you have a current copy of the blockchain, it's time to create your wallet in the ~/Desktop/TurtleCoin/ folder.

Open a new terminal window and enter the commands shown below. Note that you should have two terminal windows open: one for connecting to the blockchain and a second window for interfacing with the wallet.

cd ~/Desktop/TurtleCoin
./simplewallet

Follow the instructions in the terminal to create a new wallet.
To test your wallet, go to faucet.trtl.me for free TRTLs.

Miner (CPU only)

To starting mining turtle coins on your Mac, the xmr-stak miner can be complied from source. This requires the Homebrew package manager for macOS.

Go to the xmr-stak/releases page and download the latest source code as a zip file.
Place the file on your desktop at ~/Desktop/xmr-stak-2.2.0/
Instructions for building the xmr-stak miner for macOS are available in the compile_MacOS document. For CPU only mining, you can follow this installation procedure:

brew install hwloc
brew install libmicrohttpd
brew install gcc
brew install openssl
brew install cmake
cmake . -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl -DCUDA_ENABLE=OFF -DOpenCL_ENABLE=OFF
make install

After the installation, you may want to remove cache and log files with the brew cleanup command.

After the build is complete, go to the bin folder and run the miner.

cd ~/Desktop/xmr-stak-2.2.0/bin/
./xmr-stak

During the intial setup, xmr-stak with ask a series of questions to configure the miner with a mining pool. Below is an example of using the ny.minetrtl.us pool:

Please enter:
- Currency: 'monero' or 'aeon'
monero
- Pool address: e.g. pool.usxmrpool.com:3333
ny.minetrtl.us:3333
- Username (wallet address or pool login):
TRTLuxbuW9uZfhAgmLpK8mfisSScfp325GiTHbD2he3eFHcrxbaHxaQRNJcnA42pbSejGaLEcCvGCeiHDr1Frz8YC71hbWUEVYa
- Password (mostly empty or x):
x
- Does this pool port support TLS/SSL? Use no if unknown. (y/N)
no
- Do you want to use nicehash on this pool? (y/n)
no
- Do you want to use multiple pools? (y/n)
no

If the miner was successfully installed and configured, it will automatically begin mining turtle coins using the pool address. If you receive warnings about MEMORY ALLOC FAILED: mmap failed try to close all other programs then restart xmr-stak in the terminal.

Miner (GPU and CPU)

If you want to mine with your GPU and CPU, follow the steps above but enable the OpenCL option:

cmake . -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl -DCUDA_ENABLE=OFF -DOpenCL_ENABLE=ON

Mining with the GPU may give a better hash rate but it can also slow down your system to an unusable state.

Pool

Multiple pools are available for mining turtle coins. In the examples above, the ny.minetrtl.us:3333 is used. See the TurtleCoin documentation for a listing of other pools.

To check your status and payment history as you are mining, go to the URL of the mining pool. For example, if you mined from the ny.minetrtl.us:3333 pool, go to the ny.minetrtl.us website to view the status of the pool.

Summary

Once you have everything setup, follow the steps below to use your wallet or start mining turtle coins.

To sync the blockchain and open your wallet:

Go to the ~/Desktop/TurtleCoin/ folder in a new terminal window
Run ./TurtleCoind to sync the blockchain
Keep the blockchain window open
In a second terminal window run ./simplewallet to generate, open, or import a wallet