🐧 Linux Setup Guide

Get a Minima node running on Linux in two commands

Quick Start

Install Java, download Minima, and run it. Replace INSERTPASSWORD with a password of 12+ characters.

# Ubuntu/Debian — install Java
sudo apt update && sudo apt install -y openjdk-17-jre-headless

# Download and run Minima
mkdir -p ~/minima && cd ~/minima
wget https://github.com/minima-global/Minima/releases/latest/download/minima.jar
java -jar minima.jar -data .minima -mdsenable -mdspassword INSERTPASSWORD

For Fedora/RHEL: sudo dnf install java-17-openjdk-headless. For Arch: sudo pacman -S jre-openjdk-headless.

Minima starts and logs appear in the terminal. Open https://127.0.0.1:9003 to access your MiniDapp Hub (accept the self-signed certificate warning).

After Install

⚠️ 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.

💡 Keep It Running

Closing the terminal stops Minima. Use tmux or screen to keep it running in the background, or see the Systemd Service section below for always-on operation.

Next Steps

🛒

Setup miniMerch

Create your first shop.
❓

FAQ

Common questions answered.
Troubleshooting

"java: command not found"

Install Java 17+ using the commands above for your distro.

Firewall blocking connections

sudo ufw allow 9001 (P2P) and sudo ufw allow 9003 (MDS web interface).

Need help?

Advanced: Systemd Service (Always-On VPS)

For a server that auto-starts on boot and restarts on failure:

# Create user and download
sudo adduser minima
sudo su minima
cd /home/minima
wget https://github.com/minima-global/Minima/raw/master/jar/minima.jar
exit

# Create service (replace yourpasswordhere)
sudo tee /etc/systemd/system/minima.service <<EOF >/dev/null
[Unit]
Description=minima
[Service]
User=minima
Type=simple
ExecStart=/usr/bin/java -jar /home/minima/minima.jar -mdsenable -mdspassword yourpasswordhere -daemon -basefolder /home/minima -data /home/minima/.minima
Restart=always
RestartSec=100
[Install]
WantedBy=multi-user.target
EOF

# Start it
sudo systemctl daemon-reload
sudo systemctl enable minima
sudo systemctl start minima
sudo journalctl -u minima -f   # Ctrl+C to exit logs

Firewall (UFW)

sudo ufw allow ssh
sudo ufw allow 9001          # P2P relay
sudo ufw allow from YOUR_IP to any port 9003  # MDS (your IP only)
sudo ufw enable

Useful Commands

sudo systemctl status|stop|start|restart minima — sudo journalctl -u minima -f

Advanced: Docker

For Docker-based installations, see the dedicated Docker guide.