🔨 AMMOcoin v1.1.0 Build & Setup Guide

ℹ️ Note: Pre-built installers are available on the Downloads page. The instructions below are for building from source.

🚀 Quick Start (Recommended)

Option A: Quick Daemon Build

Best for: Users who need the daemon only (recommended for emergency update)

# 1. Clone the repository
git clone https://github.com/everquin/AMMOcoin.git
cd AMMOcoin

# 2. Navigate to quick build directory
cd ammocoin-source

# 3. Install dependencies (Ubuntu/Debian)
sudo apt update
sudo apt install build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils python3
sudo apt install libboost-system-dev libboost-filesystem-dev libboost-chrono-dev libboost-test-dev libboost-thread-dev
sudo apt install libdb4.8-dev libdb4.8++-dev

# 4. Build
./autogen.sh
./configure
make

# 5. Binaries will be in src/
ls src/ammocoind src/ammocoin-cli src/ammocoin-tx

Option B: Full Build with GUI

Best for: Users who want the complete wallet application with graphical interface

# 1. Clone the repository
git clone https://github.com/everquin/AMMOcoin.git
cd AMMOcoin

# 2. Navigate to full build directory
cd ammocoin-apps-from-ammocoin

# 3. Install additional GUI dependencies
sudo apt install qtbase5-dev qttools5-dev-tools qttools5-dev libqrencode-dev

# 4. Follow build instructions in the directory
# (Specific build steps will be in that directory's README)

Option C: Automated Emergency Build

Note: Review the script before running for security

# 1. Download and review the emergency build script
wget https://raw.githubusercontent.com/everquin/AMMOcoin/main/EMERGENCY_BUILD.sh
cat EMERGENCY_BUILD.sh  # Review the script first!

# 2. Make executable and run
chmod +x EMERGENCY_BUILD.sh
./EMERGENCY_BUILD.sh

🔧 Platform-Specific Instructions

Windows (WSL Recommended)

For Windows users, we recommend using Windows Subsystem for Linux (WSL) to build AMMOcoin.

# Install WSL and Ubuntu
wsl --install

# Then follow the Ubuntu instructions above inside WSL

macOS

# Install Homebrew dependencies
brew install autoconf automake libtool pkg-config openssl boost berkeley-db4

# Clone and build (same as Linux instructions above)
git clone https://github.com/everquin/AMMOcoin.git
cd AMMOcoin/ammocoin-source
./autogen.sh
./configure
make

⚡ Initial Setup

1. Create Data Directory

# Linux/macOS
mkdir -p ~/.ammocoin

# Windows (in WSL)
mkdir -p /mnt/c/Users/YourUsername/AppData/Roaming/ammocoin

2. First Run

# Start the daemon
./src/ammocoind -daemon

# Check if it's running
./src/ammocoin-cli getinfo

# Create a new wallet
./src/ammocoin-cli createwallet "main"

3. 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 (optional)
./src/ammocoin-cli walletpassphrase "YourStrongPassphrase" 0 true

💰 Basic Wallet Operations

Get New Address

./src/ammocoin-cli getnewaddress

Check Balance

./src/ammocoin-cli getbalance

Send AMMO

# Unlock wallet first
./src/ammocoin-cli walletpassphrase "YourPassphrase" 60

# Send coins
./src/ammocoin-cli sendtoaddress "address" amount

🔒 Security Best Practices

Essential Security Steps:

Backup wallet.dat: cp ~/.ammocoin/wallet.dat ~/wallet-backup.dat
Write down seed phrase: ./src/ammocoin-cli dumpwallet wallet.txt
Store backups offline in multiple secure locations
Never share private keys or wallet files
Use strong encryption passwords

🛠️ Troubleshooting

Build Issues

If build fails, ensure you have all dependencies:

# Re-install dependencies
sudo apt update && sudo apt upgrade
sudo apt install build-essential cmake git

Sync Issues

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

# Add nodes manually if needed
./src/ammocoin-cli addnode "node-ip:port" "add"

📞 Support Resources

Remember: Please update promptly to maintain network connectivity and benefit from the latest security improvements.