MacOS

The project is still in beta, join the Discord for support and to help out.

Machinaris runs well inside Docker on MacOS (Intel) systems, though unfortunately not yet MacOS (Apple) systems. First, install and configure Docker Desktop for MacOS.

Launching Machinaris

In Terminal, enter the following command:

docker run --name machinaris -t -p 8444:8444 -p 8926:8926 -e TZ=MY_TIMEZONE -v /Users/MY_USERNAME/.machinaris:/root/.chia:rw -v /Volumes/MY_PLOTTING_DRIVE:/plotting:rw -v /Volumes/MY_PLOTS_DRIVE:/plots:rw -d ghcr.io/guydavis/machinaris

Replacements above to make are:

• MY_TIMEZONE: Change to your local timezone such as America\Edmonton. Use TZ database name from this list.
• MY_USERNAME: Your username in MacOS. Gives path like -> /Users/jimbo/.machinaris
• MY_PLOTTING_DRIVE: Probably the volume, and optionally path, to your fast temporary plotting space.
• MY_PLOTS_DRIVE: Probably the volume, and optionally path, to your finished plots storage.

When you run this command, you will be launching a fullnode of Chia along with Plotman CLI and Machinaris WebUI on top. Check the Docker log output and browse to http://localhost:8926.

NOTE:

• If you have an existing private key mnemonic, you can import it. Otherwise, Machinaris will prompt you to generate a new one on first launch.
• If you don't want to run a full-node, but just want to plot for example, then add -e mode=plotter to above run command. Other modes include farmer and harvester.
• Docker requires ports exposed via -p 8926:8926 such as in above example. If you can't reach the WebUI, please double check this is present in your docker run command.

Post-Install Configuration

Once you have Machinaris installed on your Macintosh, you should follow these generic post-install setup steps.