Skip to main content


How to download and install Minima on your Mac

These instructions will set Minima up as a service on your Mac, so that it can run in the background without having to keep your Terminal open.

  1. If you have not run Minima before, please ensure you have the latest version of Java installed
  2. If you have a previous version of Minima running, type quit into the Terminal command line, then replace your existing minima.jar file with the latest version.

If you have not used Homebrew before, you will need to install it first:

  1. Open a Terminal window
  2. Copy and execute the following script to install Homebrew. Follow all onscreen instructions and provide your system password when required:
/bin/bash -c "$(curl -fsSL"
  1. Once Homebrew is installed, or if already installed, you can follow the following steps to install and configure your node - please ensure you provide your system password when prompted:
1 - brew tap minima-global/minima
2 - brew install minima-global/minima/minima
3 - brew services start minima

Your Terminal will provide details of where your logs can be found, which you may need in the future. Please make a note of this location for future reference.

To update Minima to a new version:
1 - mcli quit
2 - brew services stop minima
3 - brew tap minima-global/minima
4 - brew install minima-global/minima/minima
5 - brew services start minima

To check your incentive account is connected:

mcli incentivecash

Congratulations - your node is now installed & running! The last step is to connect it to your Incentive Account.

How to set up your Incentive Program account to receive rewards

Previous users

If you had an account prior to 6th December 2021, you will need to reset your password using the Forgot Password button (this is because encrypted passwords could not be migrated to the new system.) You can set your new password to be the same as your old one. Please check your junk mail for the reset password email. Once logged in, copy your Node ID.

New users

After you have registered and once Minima is running, login to your Incentive Account at and copy your Node ID.

Then run the following common in your Terminal, replacing xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx with the copied Node ID:

mcli incentivecash uid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Once this is done, your installation is complete and your Incentive account is connected to your node! You may close your Terminal Window.

  1. Your node will then ping us so we know it's running.

  2. For every day your node pings us, we will add 1 Minima to your DAILY REWARDS.

  3. To see your rewards, type mcli incentivecash into the Terminal.

Last Ping

This is the last date and time your node sent a PING message. Pings are sent at random each day. For every day your node pings us, we will add 1 Minima to your rewards.


There will temporarily be no MiniHub or MiniDapps - based on community feedback we are working hard to improve the MiniDapp system for a future release!

Useful Commands

Stopping/starting Minima

brew services stop minima : Stop the Minima service
brew services start minima : Start the Minima service

Interacting with Minima

mcli status : shows the status of Minima 
mcli incentivecash : shows your incentive cash balance
mcli help : shows the full list of commands

For a full list of Minima Terminal Commands see Terminal Commands.