Installation Guide

This guide will walk you through installing GMBOX on your system. GMBOX is available for Windows, macOS, and Linux with native optimizations for each platform.

System Requirements

Minimum Requirements

• Memory: 4 GB RAM
• Storage: 2 GB free space
• Network: Internet connection for blockchain synchronization
• Graphics: Hardware acceleration recommended

Supported Operating Systems

• Windows: Windows 10 (64-bit) or later
• macOS: macOS 11.0 or later (Intel and Apple Silicon)
• Linux: Ubuntu 20.04+, Debian 11+, Fedora 35+, or equivalent

Download GMBOX

1. Visit the official download page
2. Select your operating system
3. Download the installer package
4. Verify the SHA256 checksum (recommended)

Verifying Downloads

For enhanced security, always verify your download:

Windows (PowerShell)

Get-FileHash -Path "GMBOX-1.0.0-win64.exe" -Algorithm SHA256

macOS/Linux (Terminal)

shasum -a 256 GMBOX-1.0.0-darwin.dmg

Compare the output with the checksum provided on the download page.

Installation Instructions

Windows

1. Run the Installer

   • Double-click the downloaded .exe file
   • If Windows SmartScreen appears, click "More info" then "Run anyway"

2. Installation Wizard

   • Follow the installation wizard prompts
   • Choose installation directory (default recommended)
   • Select additional components if desired

3. First Launch

   • Launch GMBOX from the Start Menu or desktop shortcut
   • Allow firewall access when prompted

macOS

1. Mount the Disk Image

   • Double-click the downloaded .dmg file
   • The GMBOX disk image will mount

2. Install the Application

   • Drag GMBOX to your Applications folder
   • Eject the disk image

3. First Launch

   • Open GMBOX from Applications
   • If you see a security warning, go to System Preferences > Security & Privacy and click "Open Anyway"

Linux

Ubuntu/Debian (.deb package)

# Download the package
wget https://releases.walletname.com/v1.0.0/walletname_1.0.0_amd64.deb

# Install
sudo dpkg -i walletname_1.0.0_amd64.deb

# Install dependencies if needed
sudo apt-get install -f

Fedora/CentOS (.rpm package)

# Download the package
wget https://releases.walletname.com/v1.0.0/walletname-1.0.0.x86_64.rpm

# Install
sudo rpm -i walletname-1.0.0.x86_64.rpm

# Or using dnf
sudo dnf install walletname-1.0.0.x86_64.rpm

AppImage (Universal Linux)

# Download AppImage
wget https://releases.walletname.com/v1.0.0/GMBOX-1.0.0.AppImage

# Make executable
chmod +x GMBOX-1.0.0.AppImage

# Run
./GMBOX-1.0.0.AppImage

Initial Setup

First Launch

When you first open GMBOX, you'll be guided through the initial setup:

1. Welcome Screen

   • Choose your preferred language
   • Review the terms of service

2. Security Setup

   • Set a strong master password
   • Choose backup preferences
   • Configure biometric authentication (if available)

3. Network Configuration

   • Select which blockchains to enable
   • Configure node connections
   • Set up proxy settings if needed

Creating Your First Wallet

1. Wallet Type Selection

   • Create new wallet (generates new keys)
   • Import existing wallet (from recovery phrase)
   • Connect hardware wallet

2. Security Configuration

   • Generate recovery phrase (12 or 24 words)
   • Important: Write down your recovery phrase and store it securely
   • Verify the recovery phrase
   • Set up additional security features

3. Account Setup

   • Name your wallet
   • Configure account derivation paths
   • Set up multi-chain accounts

Configuration

Performance Optimization

Hardware Acceleration

• Enable GPU acceleration for better performance
• Configure memory allocation based on your system
• Adjust sync settings for your network speed

Network Settings

• Configure RPC endpoints for optimal performance
• Set up custom nodes if desired
• Enable or disable specific blockchain networks

Security Settings

Access Control

• Set auto-lock timeouts
• Configure biometric authentication
• Set up session management

Privacy Settings

• Configure transaction privacy levels
• Set up address rotation policies
• Configure data sharing preferences

Troubleshooting

Common Installation Issues

Windows Defender/Antivirus Warnings

• GMBOX may trigger false positives due to cryptocurrency-related functionality
• Add GMBOX to your antivirus whitelist
• Download only from official sources

macOS Gatekeeper Issues

• If the app won't open, use System Preferences > Security & Privacy
• Click "Open Anyway" for GMBOX
• Ensure you downloaded from the official site

Linux Dependency Issues

# Ubuntu/Debian missing dependencies
sudo apt-get update
sudo apt-get install libgtk-3-0 libx11-xcb1 libxcb-dri3-0

# Fedora missing dependencies
sudo dnf install gtk3 libX11-xcb xcb-util-renderutil

Performance Issues

High Memory Usage

• Reduce the number of active blockchain connections
• Decrease sync frequency for unused networks
• Close unused plugins

Slow Synchronization

• Check your internet connection
• Try different RPC endpoints
• Consider using light sync mode

Getting Help

If you encounter issues during installation:

1. Check our troubleshooting guide
2. Search the community forums
3. Report bugs on GitHub Issues
4. Contact support through our Discord server

Next Steps

After successful installation:

1. Set up your first wallet
2. Learn about core features
3. Explore the plugin marketplace
4. Join the community

Security Reminders

• Always download GMBOX from official sources
• Verify checksums when possible
• Keep your recovery phrase secure and offline
• Enable automatic updates for security patches
• Regular backup your wallet data

Installation complete? Great! Check out our usage guide to get started with GMBOX.