🍎 macOS Setup Guide

Get a Minima node running on your Mac in under a minute

Install Minima

Open Terminal and paste this:

curl -sL https://raw.githubusercontent.com/eurobuddha/minima-installer/main/setup-minima.command | bash

This installs Java (if needed), downloads Minima, and opens a setup wizard in your browser. Everything is automatic.

After Install

Once the setup wizard finishes, your node is running. Open https://127.0.0.1:9003 to access your MiniDapp Hub.

⚠️ Write Down Your Seed Phrase

Open the Security MiniDapp and back up your 24-word seed phrase immediately. It is the only way to recover your coins. Write it on paper and store it safely.

Next Steps

🛒

Setup miniMerch

Create your first shop.
❓

FAQ

Common questions answered.
Troubleshooting

macOS blocks the installer

Go to System Settings → Privacy & Security, scroll down, and click Open Anyway.

Sync is stuck

  • Check your internet connection
  • Restart Minima
  • Make sure your Mac isn't sleeping

Need help?

Advanced: Alternative Install Methods

OpenWebStart (Desktop App)

  1. Download OpenWebStart (Intel: x64, Apple Silicon: aarch64)
  2. Install and allow it in System Settings → Privacy & Security
  3. Download minima.jnlp (right-click → Save Link As)
  4. Double-click the JNLP file to launch Minima
  5. Set a password (12+ chars) in Settings → Advanced params: -mdspassword YOUR_PASSWORD

Important: Always shut down Minima before shutting down your Mac to avoid database corruption.

Command Line (JAR)

mkdir -p ~/minima && cd ~/minima
curl -L -o minima.jar https://github.com/minima-global/Minima/releases/latest/download/minima.jar
java -jar minima.jar -data .minima -mdsenable -mdspassword INSERTPASSWORD

Requires Java 17+. Install via brew install openjdk@17. Closing the terminal stops Minima.