🐳 Docker Setup Guide

Run Minima on a Linux VPS using Docker

Quick Start

⚠️ Firewall Warning

Docker bypasses UFW. Use your VPS provider's firewall manager. Open port 9001 (P2P) to all, and port 9003 (MDS) to your IP only.

Replace INSERTPASSWORD with a strong password (12+ characters):

# Create user and install Docker
sudo adduser minima
sudo usermod -aG sudo minima
su - minima
sudo curl -fsSL https://get.docker.com/ -o get-docker.sh
sudo chmod +x ./get-docker.sh && ./get-docker.sh
sudo usermod -aG docker $USER
exit && su - minima

# Start Minima
docker run -d \
  -e minima_mdspassword=INSERTPASSWORD \
  -e minima_server=true \
  -v ~/minimadocker9001:/home/minima/data \
  -p 9001:9001 -p 127.0.0.1:9003:9003 \
  --restart unless-stopped \
  --name minima9001 minimaglobal/minima:latest

# Auto-updates via Watchtower
docker run -d --restart unless-stopped --name watchtower \
  -e WATCHTOWER_CLEANUP=true -e WATCHTOWER_TIMEOUT=60s \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower

# Enable Docker on boot
sudo systemctl enable docker.service containerd.service

Log In

MDS is bound to localhost. Use an SSH tunnel to access it: ssh -L 9003:127.0.0.1:9003 minima@YourServerIP, then open https://localhost:9003 (accept the self-signed certificate warning).

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

Next Steps

🛒

Setup miniMerch

Create your first shop.
Useful Docker Commands
CommandWhat It Does
docker logs minima9001View logs
docker stop minima9001Stop
docker start minima9001Start
docker restart minima9001Restart
docker ps -aList all containers
Changing Password / Removing Node

Change Password

docker stop minima9001 && docker rm minima9001, then re-run the docker run command with a new password. Your data folder is preserved.

Remove Node

⚠️ Back up your seed phrase first

Removing the data folder deletes your coins permanently.

docker stop minima9001 && docker rm minima9001
sudo rm -rf ~/minimadocker9001
Optional Startup Parameters
ParameterDescription
-e minima_clean=trueFresh start (WARNING: deletes all data)
-e minima_archive=trueArchive node (full chain history)
-e minima_desktop=trueDisable incoming connections
-e minima_rpcenable=trueEnable RPC (add -p 127.0.0.1:9005:9005)
-e minima_rpcpassword=PASSRPC auth password