Install — Pocket 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 Pocket Shop Studio or the CLI.

A

Option A: Studio Desktop App (Recommended)

Download Pocket Shop Studio from GitHub Releases.

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.

Studio opens at http://localhost:3456. Go to Vendor Setup, paste your address and public key, then go to Build Shop and fill in your product details.

B

Option B: Command Line

          npm i -g pocketshop

          pocketshop

Or clone the repo and run node build-pocketshop.js <address> <pubkey>

Step 4: Deploy

Two files, two installs — then you're live.

1

Install mInbox on your node

Open the MiniDapp Hub, tap +, select mInbox.zip. This receives and decrypts your orders.

2

Publish the shop to PocketWeb

Open PocketFS on your node, upload [productname].mds.zip. Your shop is now broadcast to every node on the network — searchable by keyword and accessible by address. No link sharing needed.

3

Start selling

Orders appear in mInbox automatically. Update status, reply via ChainMail, export to CSV.

Don't have PocketFS and PocketWeb installed? Get them from pocketweb.uk.

Install Guide

Mac