AMMOcoin Wallet & Node Setup Guide

Status: The v1.0 chain is halted. v1.1.1 (Proof of Stake from block 2,776) is released on GitHub. Do not install v1.1.0: it runs the pre-fork chain that stalled at block 2,775.
Note: Pre-built v1.1.1 downloads (Windows installer and Qt wallet, macOS wallet app and tools for Apple Silicon and Intel, Linux desktop wallet, Linux x86_64 and ARM64 / Raspberry Pi server packages) are listed on the Downloads page, with their checksums. The build instructions below are for building from source.

Install a Release (v1.1.1)

Verify every download against AMMOcoin-v1.1.1-ALL-PLATFORMS-CHECKSUMS.txt first (see Verify your download). The commands below use ./src/ paths from a source build; with a release, run ammocoind and ammocoin-cli from wherever you installed them.

System Requirements

Build From Source (Linux)

The source code lives in the source/ folder of the AMMOcoin repository. The full dependency list (including Berkeley DB 4.8 and the Rust toolchain) is in the Linux build instructions.

# 1. Clone the repository
git clone --branch v1.1.1 https://github.com/everquin/AMMOcoin.git
cd AMMOcoin/source

# 2. Install dependencies: follow the Linux build instructions linked above

# 3. Build (the Qt wallet is built too when the Qt development packages are installed)
./autogen.sh
./configure
make -j$(nproc)

# 4. Binaries are in src/ (and src/qt/ for the GUI wallet)
ls src/ammocoind src/ammocoin-cli src/ammocoin-tx

Windows

Use the installer from the Downloads page, or build inside Windows Subsystem for Linux (wsl --install, then follow the Linux steps). Cross-compiling is covered in the cross-compile folder.

macOS

See the macOS install guide.

Data Folders

v1.1.1 creates and uses a new data folder automatically, so it never opens v1.0 data: 
# v1.1.1 data folder
# Linux:   ~/.ammocoin11
# macOS:   ~/Library/Application Support/AMMOcoin11
# Windows: %APPDATA%\AMMOcoin11

# Sapling parameters (needed to start the node)
# Linux:   ~/.ammocoin-params
# macOS:   ~/Library/Application Support/AMMOcoinParams
# Windows: %APPDATA%\AMMOcoinParams

First Run

# Start the daemon
./src/ammocoind -daemon

# Check it is running
./src/ammocoin-cli getinfo

# The wallet is created automatically on first start.
# Get an address to receive AMMO:
./src/ammocoin-cli getnewaddress

Secure Your Wallet

Critical: Encrypt your wallet immediately! 
# Encrypt wallet with a strong passphrase
./src/ammocoin-cli encryptwallet "YourStrongPassphrase"

# The daemon will stop - restart it
./src/ammocoind -daemon

# Unlock for staking only (Proof of Stake starts with v1.1.1; coins need 600 confirmations)
./src/ammocoin-cli walletpassphrase "YourStrongPassphrase" 0 true

To stake without keeping your keys on a server at all, use cold staking.

Basic Wallet Operations

# New address
./src/ammocoin-cli getnewaddress

# Balance
./src/ammocoin-cli getbalance

# Send (unlock first)
./src/ammocoin-cli walletpassphrase "YourPassphrase" 60
./src/ammocoin-cli sendtoaddress "address" amount

Running a Node on a Linux Server

For a staking server or masternode. Requires Ubuntu 22.04 or newer.

systemd service

Save as /etc/systemd/system/ammocoind.service. The Environment=HOME= line is required: without it the node cannot find its Sapling parameters and stops with "Cannot find the Sapling parameters". Use the home folder of the user that runs the node (/root if it runs as root).

[Unit]
Description=AMMOcoin daemon
After=network-online.target
Wants=network-online.target

[Service]
User=root
Environment=HOME=/root
ExecStart=/usr/local/bin/ammocoind -datadir=/root/.ammocoin11 -daemon=0
ExecStop=/usr/local/bin/ammocoin-cli -datadir=/root/.ammocoin11 stop
Restart=on-failure
RestartSec=30

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now ammocoind
sudo systemctl status ammocoind

Backups

  • Back up wallet.dat: ./src/ammocoin-cli backupwallet ~/wallet-backup.dat, or copy ~/.ammocoin11/wallet.dat while the node is stopped (Linux, v1.1.1). Keep your v1.0 wallet.dat backed up too.
  • Export your keys (optional): ./src/ammocoin-cli dumpwallet wallet.txt. This file holds your private keys in plain text: store it offline and delete it from the computer afterwards.
  • Store backups offline in multiple secure locations.
  • Never share private keys or wallet files.

Troubleshooting

Sync Issues

# Check peer connections
./src/ammocoin-cli getconnectioncount

# Add nodes manually if needed
# Seeds: seed1.ammocoin.org (78.141.194.140), seed2.ammocoin.org (104.238.165.56), seed3.ammocoin.org; P2P port 37020
./src/ammocoin-cli addnode "seed1.ammocoin.org:37020" "add"
./src/ammocoin-cli addnode "seed2.ammocoin.org:37020" "add"

Support Resources