Skip to content

MacOS

Jump to bottom
Guy Davis edited this page Jun 16, 2021 · 25 revisions

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. The following guide covers a standalone install on a single machine.

Standalone

Machinaris also supports monitoring and controlling multiple worker installs on your local area network.

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.

MacOS

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.

Trademark Notice

CHIA NETWORK INC, CHIA™, the CHIA BLOCKCHAIN™, the CHIA PROTOCOL™, CHIALISP™ and the “leaf Logo” (including the leaf logo alone when it refers to or indicates Chia), are trademarks or registered trademarks of Chia Network, Inc., a Delaware corporation. There is no affiliation between the Machinaris project and the main Chia Network project.

Clone this wiki locally