Mochimo Server

Prerequisites

PLEASE NOTE:

• THIS GUIDE IS FOR LINUX ONLY

As of July 2022, we recommend using Ubuntu 20.04 LTS. If that's not your favorite flavor of OS, the code will compile without issue on most 64-bit Linux-based machines.

Recommended system requirements (for all versions up to at least v2.4.2):

• (OS) Ubuntu 20.04 LTS
• (CPU) Dual-core Processor
• (RAM) 2GB of Random Access Memory
• (SSD) 64GB of Solid State Drive Storage
• (NETWORK) Port 2095 incoming TCP/IPv4 access
  • may require router port forwarding

If Ubuntu is not your favorite flavor, the code will compile without issue on most 64-bit Linux-based machines.

The minimum requirements are a little modest, but they may cover future planned versions of the codebase as well. For example, v2.4.2 runs on a Raspberry Pi 4 with total RAM consumption at around 100MB (system usage included).

Some systems do not come with build tools and/or git pre-installed. For those systems, run the following to install or update accordingly:

Ubuntu/Debian (apt)

sudo apt-get install -y build-essential git-all

Clone the Official Mochimo Github Repository

git clone https://github.com/mochimodev/mochimo ~/mochimo

If you have a previous version of the cloned repository, you can update with:

git -C ~/mochimo pull

Verify the version from the Mochimo Github Repository homepage, matches the version shown by the following command:

make -C ~/mochimo version

Build the Mochimo Server binary

make -C ~/mochimo install-mochimo

If all succeeds, you can find the gomochi start script at ~/mochimo/bin/gomochi.

Usage

To start your relay-node server:

cd ~/mochimo/bin # change to the binary directory
./gomochi -n # start the relay-node (-n for no mining)

Run into issues?

Let us know on Discord.