Get a Minima node running, then build and deploy your Pocket Shop.
Download the Minima app from the Google Play Store (or APK from GitHub). Open it — your node starts automatically and runs in the background.
Allow battery optimisation exemption for reliable operation. On first launch, write down your seed phrase immediately (Security → Manage Seed Phrase).
1. Install Java if you don't have it:
2. Download minima.jar from the Minima GitHub releases page.
3. Open Terminal, create a folder and start:
4. Open https://127.0.0.1:9003 in your browser (proceed past the SSL warning). Log in with your password.
1. Install Java from java.com or Adoptium. Verify with:
2. Download minima.jar from the Minima GitHub releases page.
3. Create a folder (e.g. C:\minima), copy minima.jar into it. Open Command Prompt, then:
4. Open https://127.0.0.1:9003 in your browser. Log in with your password.
1. Install Java:
2. Download and start:
3. Open https://127.0.0.1:9003 in your browser. Log in with your password.
On any platform, closing the terminal stops Minima. Use tmux to keep it running in the background.
1. Install tmux:
2. Create a tmux session and start Minima inside it:
3. Detach from tmux (Minima keeps running): press Ctrl+B, then D
4. Re-attach later: tmux attach -t minima
tmux cheat sheet: Create: tmux new -s minima · Detach: Ctrl+B, D · Re-attach: tmux attach -t minima · List: tmux ls · Kill: tmux kill-session -t minima
All platforms use the same java -jar minima.jar command with these key parameters:
| Parameter | Description |
|---|---|
-data [folder] | Config folder. Default: .minima in home dir. |
-port [port] | Base port (uses +4 range). Default: 9001. MDS = base+2. |
-mdsenable | Enable the MiniDapp Hub (required for Pocket Shop). |
-mdspassword [pw] | MDS login password. |
-server | Accept incoming connections (for VPS/server). |
-daemon | No stdin input (for background services). |
-archive | Run as Archive node (stores full chain). |
-clean | CAREFUL! Wipes all data. Fresh start only. |
-rpcenable | Enable RPC for external integrations. |
-help | Print all available parameters. |
After starting your node, immediately write down your seed phrase:
Open the Security MiniDapp → Manage Seed Phrase → Show Seed Phrase
Write it on paper or a metal plate. Make 2 copies. Store in separate locations. Never screenshot or copy/paste on a connected device.
All MiniDapps start with READ permission — transactions must be approved via the Pending MiniDapp. To give a trusted MiniDapp WRITE access (no approval needed): right-click the MiniDapp (or long press on mobile) → select Write mode → Confirm.
Lock your wallet with a password before giving any MiniDapp WRITE permission.
Open the Wallet MiniDapp → Receive tab. Copy your address (starts with 0x).
Open the MDS Terminal MiniDapp. Type maxima action:info and copy the mxpublickey value (starts with Mx).
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.
Or clone the repo and run node build-pocketshop.js <address> <pubkey>
Open the MiniDapp Hub, tap +, select mInbox.zip. This receives and decrypts your orders.
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.
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.