Install Guide

Get a Minima node running, then build and deploy your miniMerch shop.

Step 1: Run a Minima Node
One command installs everything. Pick your platform.
🍎

Mac

Open Terminal and paste this:

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

Installs Java and everything else automatically. A setup wizard opens in your browser.

🪟

Windows

Open Command Prompt and paste this:

curl -o %TEMP%\setup-minima.bat https://raw.githubusercontent.com/eurobuddha/minima-installer/main/setup-minima.bat && %TEMP%\setup-minima.bat

Installs Java and everything else automatically. A setup wizard opens in your browser.

🐧

Linux

Open a Terminal and paste this:

curl -sL https://raw.githubusercontent.com/eurobuddha/minima-installer/master/setup-minima-linux.sh | bash

Installs Java and tmux automatically. Supports apt, dnf, yum, and pacman.

📱

Android

Download the Minima app from the Google Play Store. Open it — your node starts automatically.

🍓

Raspberry Pi

Flash Pi OS Lite (64-bit) with Raspberry Pi Imager (enable SSH + WiFi), then SSH in and paste:

curl -sL https://raw.githubusercontent.com/eurobuddha/raspberry/main/headless/setup-minima-headless.sh | bash

Runs as a systemd service. Access MDS Hub at https://minima.local:9003 from any device on your network. Pi 4 or Pi 5 recommended (4GB+).

After your node is running, write down your seed phrase: open the Security MiniDapp and back it up immediately.

Step 2: Get Your Vendor Credentials
You need two things from your Minima node.
1

Minima Address

Open the Wallet MiniDapp → Receive tab. Copy your address (starts with 0x).

2

Maxima Public Key

Open the MDS Terminal MiniDapp. Type maxima action:info and copy the mxpublickey value (starts with Mx).

Step 3: Build Your Shop
Use miniMerch Studio to create your multi-product store.
1

Download miniMerch Studio

Get it from GitHub Releases. Available for macOS and Windows.

macOS: Open the .dmg, drag to Applications, right-click → Open on first launch.
Windows: Run the .exe installer. Click "More info" → "Run anyway" on first launch.

2

Configure Your Shop

Studio opens at http://localhost:3456. Set up your vendor details (address + public key), add products with images, descriptions, prices, and shipping options.

3

Generate Shop

Click Generate Shop. Studio creates your shop MiniDapp and installs it directly to your node.

Step 4: Share Your Shop
Distribute your shop link to customers.
1

Your shop is on your node

After generation, your miniMerch shop is installed as a MiniDapp on your Minima node.

2

Share the link

Share your shop's MiniFS link with customers. They can access it through their own Minima node.

Want a single-product shop that's searchable on PocketWeb? Try Pocket Shop instead.

Need help?

Check the FAQ or open an issue on GitHub.

FAQ GitHub Issues