umbrel-samourai-dojo/doc/DOCKER_mac_setup.MD

MacOS Installation

This installation was tested on an iMac (mid 2011) with a 2.7GHz i5 processor with 8GB RAM and 1TB external Hard Drive.

Getting Started

Create a new user:

1. Launch System Preferences by clicking the System Preferences icon in the Dock, or selecting System Preferences from the Apple menu.
2. Click on Users & Groups
3. If settings are locked, click on the Lock at the bottom of window and enter your password.
4. Click on + to add a new User
5. Under New Account select Administrator
6. Fill the remaining fields with your choice of User Name and Password

Move the New User Folder into the External HD

Note: This is an important step, otherwise, it's probable that when you run the container, it will be installed in your main OS Hard Drive and will run out of space as it validates the Bitcoin blockchain.

1. Open Finder and navigate to your startup drive's /Users folder. For most people, this is /Macintosh HD/Users. In the Users folder, you'll find your user's folder.
2. On your external Hard Drive, create a folder named Users.
3. Select your user folder and drag it to the external HD /Users folder you created. Because you're using a different drive for the destination, the operating system will copy the data rather than move it. This ok for now but delete it later.
4. Launch System Preferences again.
5. In the Users & Groups click the lock icon in the bottom left corner, then provide an administrator name and password.
6. From the list of user accounts, right-click on the account whose home folder you moved, and select Advanced Options from the pop-up menu. Do not make any changes to Advanced Options except for those noted here. Doing so can cause quite a few unforeseen problems that could lead to data loss or the need to reinstall the operating system.
7. In the Advanced Options sheet, click Choose, located to the right of the Home directory field.
8. Navigate to the location you moved your home folder to, select the new home folder, and click OK.
9. Click OK to dismiss the Advanced Options sheet, and then close System Preferences.
10. Restart your Mac

Download and install Docker, Kitematic and TOR

1. Make sure your system fills the requirements (particularly MacOS Sierra 10.12 or higher. If not, upgrade before proceeding).
2. Download Docker and follow the installation steps.
3. Optional: Download Kitematic and follow installation instructions. (This may be system specific but I've found that monitoring the logs with Kitematic was more stable than using the Terminal).
4. Install Tor Browser on the host machine.

Adjust Docker Settings

1. Click on the Docker icon () at the status bar and select Preferences.
2. Under Disk, click on Reveal in Finder and double check that the disk image is saved under the external HD.
3. Adjust Disk Image size to 400GB+ and click Apply.
4. Click Advanced and increase the CPU count, Memory and Swap sizes. Adjusting these will speed up the blockchain validation process (At 4 CPUs, 8GB of RAM and a 4GiB Swap - the initial block download took 4.5 days at the time of writing).

Install the DOJO

Follow the instructions here starting at the step: "Download the most recent release of Dojo from Github" Note: For tracking progress, open Kitematic and follow the bitcoind logs. You'll be able to see the Blockchain verification process under the progress log variable (1.00 = fully validated). This process takes a long time. Just let it do its thing. In my system it took 3 days.

Some possible optimization tips: . If you notice that progress has stopped. Click the whale icon and select Restart. Check Kitematic logs of bitcoind to confirm that progress has resumed. . This may optimize speed: open Activity Monitor, check the PID (Process ID) of your docker process. Open Terminal and type:

sudo renice-20 -p [enter your PID]