Marscoin Full Node
Run a Marscoin full node to independently validate the blockchain, relay transactions, and strengthen network decentralization. Complete setup instructions for server and desktop environments.
Overview
A full node is the backbone of the Marscoin network. Every full node independently downloads, validates, and stores the complete Marscoin blockchain — every block since genesis, every transaction ever confirmed. Full nodes enforce the consensus rules of the protocol: they reject invalid transactions, refuse fraudulent blocks, and relay valid data to other nodes.
Running a full node is the most direct way to contribute to Marscoin’s security and decentralization. It requires no special hardware and minimal ongoing maintenance. If you have a computer with a broadband connection, you can run a node.
Why Run a Full Node
Trustless Verification
When you run a full node, you verify everything yourself. You do not depend on any third party to tell you the state of the blockchain. Your node independently confirms that every transaction follows the rules and every block is valid. This is the purest form of participation in a decentralized network.
Network Health
The Marscoin network becomes more resilient with every additional node. More nodes means:
- Faster transaction propagation — transactions reach miners more quickly
- Greater redundancy — the network can tolerate node failures without disruption
- Stronger decentralization — no single entity can control a majority of the network’s infrastructure
- Better service for lightweight wallets — SPV wallets (like Electrum) depend on full nodes for block data
Preparing for Mars
Full nodes will be essential infrastructure on Mars. The settlement will need locally operated nodes to maintain blockchain consensus without depending on Earth-based infrastructure (given the 4-to-24-minute communication delay). Every node operator today is practicing for that future and helping establish the operational knowledge the settlement will need.
System Requirements
Marscoin’s blockchain is compact, and the node software is lightweight:
| Resource | Minimum | Recommended |
|---|---|---|
| Storage | 3 GB | 10 GB (room for growth) |
| RAM | 1 GB | 2 GB |
| CPU | Any modern processor | Multi-core for faster sync |
| Network | Broadband (for initial sync) | Always-on connection |
| OS | Linux, macOS, or Windows | Linux (for servers) |
A Raspberry Pi 4 (or newer) with an SD card or USB drive is more than sufficient. Many node operators run Marscoin alongside other services on a general-purpose server.
Setup Instructions
Linux (Recommended for Servers)
- Download the latest release from GitHub:
wget https://github.com/marscoin/marscoin/releases/download/latest/marscoin-linux-x86_64.tar.gz
tar xzf marscoin-linux-x86_64.tar.gz- Create the data directory and configuration file:
mkdir -p ~/.marscoin
cat > ~/.marscoin/marscoin.conf << 'EOF'
server=1
daemon=1
rpcuser=marsrpc
rpcpassword=CHANGE_THIS_TO_A_STRONG_PASSWORD
rpcallowip=127.0.0.1
maxconnections=40
EOF- Start the node:
./marscoind -daemon- Monitor sync progress:
./marscoin-cli getblockchaininfoThe node will begin downloading and validating the blockchain. Initial sync takes a few hours on broadband.
Tip: Official blockchain snapshots are available at sync.marscoin.org to speed up the initial sync process.
Building from Source
For developers or users who prefer to compile from source:
git clone https://github.com/marscoin/marscoin.git
cd marscoin
./autogen.sh
./configure --without-gui # omit for GUI build
make -j$(nproc)
make installBuild dependencies include libssl-dev, libboost-all-dev, libevent-dev, and libdb-dev. See the GitHub repository’s build documentation for the complete list.
macOS and Windows
Download the appropriate installer from the GitHub releases page. The installation process includes the full node (marscoind) and optionally the Qt GUI. On macOS, you can also install via Homebrew if a formula is available, or build from source using the same steps as Linux.
Configuration Options
The marscoin.conf file supports many options. Key settings for node operators:
| Setting | Description | Default |
|---|---|---|
server=1 | Enable RPC server | 0 |
daemon=1 | Run in background | 0 |
maxconnections= | Maximum peer connections | 125 |
port= | P2P network port | 8332 |
rpcport= | RPC interface port | 8333 |
addnode= | Manually add a peer | — |
txindex=1 | Full transaction index (for block explorers) | 0 |
For a dedicated node, enabling txindex=1 is useful if you plan to query arbitrary transactions via RPC. It requires additional storage but makes the node more versatile.
Firewall and Port Forwarding
For your node to accept incoming connections from other nodes (rather than only making outgoing connections), you need to allow inbound traffic on Marscoin’s P2P port:
- Port: 8332 (TCP)
- Direction: Inbound
Configure your router’s port forwarding and your system’s firewall to allow this port. A node with open inbound connections contributes more to the network than one that only makes outbound connections.
Monitoring Your Node
Check Sync Status
marscoin-cli getblockchaininfoShows current block height, sync progress, and chain state.
View Connected Peers
marscoin-cli getpeerinfoLists all connected peers with their addresses, connection time, and data transfer statistics.
Check Network Hash Rate
marscoin-cli getmininginfoShows current network difficulty and estimated hash rate.
Running a Node on Raspberry Pi
The Raspberry Pi is an excellent platform for a dedicated Marscoin node — low power consumption (5-15W), silent operation, and sufficient performance for blockchain validation.
Setup is the same as Linux, using the ARM build from GitHub releases or compiling from source for ARM. Use a USB SSD rather than an SD card for storage — the blockchain’s write operations benefit from SSD durability and speed.
A Raspberry Pi Marscoin node can run 24/7 for years with minimal attention, contributing to the network around the clock at negligible electricity cost.
Help Secure the Network
Every full node is a vote for the rules of the Marscoin protocol. By running a node, you are not just passively observing the network — you are actively enforcing its rules, validating its data, and strengthening its infrastructure.
The Marscoin network today is small. Every additional node makes a meaningful difference. When the network extends to Mars, that foundation of distributed, independently operated nodes will be what makes the blockchain function across two planets.
For technical questions about node operation, visit the Marscoin GitHub or join the community on Discord and Telegram.
