🐧 Linux Setup Guide

Prerequisites

• Linux distribution (Ubuntu 20.04+, Debian 11+, Fedora 34+, or similar)
• At least 500MB of free disk space
• Stable internet connection
• Java 17 or later (required)
• Terminal access

Step 1: Install Java

Minima requires Java 17 or later. Install it using your package manager:

Ubuntu / Debian

sudo apt update
sudo apt install openjdk-17-jre-headless

Fedora / RHEL / CentOS

sudo dnf install java-17-openjdk-headless

Arch Linux

sudo pacman -S jre-openjdk-headless

Verify Java is installed:

java -version

You should see "java version 17" or higher.

Step 2: Download Minima

Download the Minima JAR file from the official website:

1. Visit minima.global/post/2024/04/10/minima-desktop-launch/
2. Download the Linux JAR file
3. Create a folder for Minima:

   mkdir -p ~/minima
   mv ~/Downloads/minima*.jar ~/minima/

mkdir -p ~/minima
cd ~/minima
wget https://github.com/minima-global/Minima/releases/latest/download/minima.jar

Step 3: Run Minima

Navigate to your Minima folder and run the application:

cd ~/minima
java -jar minima.jar

Minima will start and show output like:

Minima @ [date] : Welcome to Minima
Minima @ [date] : Generating Base Private Seed Key
Minima @ [date] : Ready - listening on port 9001

Running in Background (tmux/screen)

To keep Minima running after you close the terminal:

# Using tmux (recommended)
tmux
java -jar minima.jar
# Press Ctrl+B, then D to detach

# Or using screen
screen -S minima
java -jar minima.jar
# Press Ctrl+A, then D to detach

Step 4: Your Wallet

The Minima node IS your wallet. There's a built-in Wallet MiniDapp for managing your tokens.

1. Look for the Wallet MiniDapp in your MiniDapp Hub
2. Open it to see your addresses and balance
3. Your 24-word recovery phrase is stored securely - back it up if you haven't already

Step 5: Connect to Network

On first run, Minima connects to the network - this takes about 10 seconds.

1. When prompted, confirm to connect to the network
2. Wait a few seconds for the connection
3. You're ready to go!

Step 6: Access MiniDapps

Minima includes a web interface for MiniDapps:

1. Make sure Minima is running
2. Open your web browser
3. Go to: https://127.0.0.1:9003
4. You'll see the MiniDapp Hub

Optional: Run as Systemd Service

For auto-start and reliable uptime, create a systemd service:

sudo nano /etc/systemd/system/minima.service

Add this content:

[Unit]
Description=Minima Node
After=network.target

[Service]
Type=simple
User=YOUR_USERNAME
WorkingDirectory=/home/YOUR_USERNAME/minima
ExecStart=/usr/bin/java -jar /home/YOUR_USERNAME/minima/minima.jar
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Then enable and start:

sudo systemctl daemon-reload
sudo systemctl enable minima
sudo systemctl start minima

# Check status
sudo systemctl status minima

Troubleshooting

"java: command not found"

Java is not installed or not in your PATH. Install Java 17+ or add it to PATH.

Permission denied errors

• Make sure you have write permissions to the Minima folder
• Try: chmod +x minima.jar

Firewall blocking connections

• Allow port 9001: sudo ufw allow 9001
• For MiniDapps (port 9003): sudo ufw allow 9003

Need more help?

• Visit the Minima Documentation
• Join the Minima Discord

Next Steps

Now that you have Minima installed: