Skip to main content

Installation

Get Fever CLI installed and ready to revolutionize your smart contract deployment workflow in under 2 minutes.

What You're Installing​

Fever CLI is an all-in-one command-line tool that gives you:

  • 🎯 Manifest-driven deployment - Stop writing scripts, start declaring
  • 💎 PackageSystem support - Build modular, upgradeable systems
  • 🔨 Smart compiler - Auto-detects Solidity versions
  • 🌐 Local blockchain - Built-in Anvil node wrapper
  • 📊 Platform integration - Automatic deployment tracking
  • ⚡ Smart artifact sync - 70-90% bandwidth savings
  • 🎯 CREATE2 support - Deterministic cross-chain deployments

Time to first deployment: Under 10 minutes after installation!

Requirements​

Before installation, ensure you have:

  • Node.js: Version 20.x or higher is required for full compatibility
  • npm: Comes bundled with Node.js
Check Your Node Version
node --version  # Should be v20.x or higher
npm --version   # Should be 9.x or higher

Need to upgrade? Visit nodejs.org or use nvm for version management.

Standard Installation​

The recommended way to install Fever CLI is globally using npm. This makes the fever command available in any terminal session.

npm install -g @fevertokens/cli

Installation time: ~30 seconds

Verification​

After installation, verify that the CLI is working correctly:

fever --version

You should see the installed version number (e.g., 0.0.15).

Check authentication status (should report "not logged in" for first-time users):

fever auth status

Expected output:

❌ Not authenticated
Run 'fever auth login' to authenticate
All Systems Go! ✅

If you see the version number and auth status, Fever CLI is installed correctly!

What's Next?​

Now that Fever CLI is installed, you have two paths:

🚀 Fast Track: Quickstart Tutorial (Recommended)​

Deploy a complete 7-contract DeFi lending system in 15 minutes:

👉 Start the Interactive Quickstart

You'll learn by doing:

  • Compile and deploy contracts
  • Use manifest-driven deployment
  • Deploy a PackageSystem with multiple packages
  • Track everything on the Fever platform

Duration: 15-20 minutes | Level: Beginner to Advanced

📚 Step-by-Step: Getting Started Guide​

Prefer a methodical approach? Start here:

👉 Begin the Getting Started Guide

You'll learn:

  • Authenticate with the platform
  • Create your first project
  • Deploy a simple ERC20 token
  • Understand manifest basics

Duration: 10 minutes | Level: Beginner

Optional: Install Foundry (for local development)​

For local blockchain testing, install Foundry (includes Anvil):

curl -L https://foundry.paradigm.xyz | bash
foundryup

Verify Anvil installation:

anvil --version
What is Anvil?

Anvil is a blazing-fast local Ethereum node written in Rust. Fever CLI's fever node command uses Anvil for local development and testing.

Features:

  • Instant block mining
  • Pre-funded test accounts
  • Mainnet forking support
  • Zero configuration needed

You can skip this for now - the Getting Started and Quickstart guides will remind you when you need it.

Troubleshooting​

Permission Errors (EACCES)​

If you encounter a permission error (often with EACCES in the message) during global installation, it means npm does not have the rights to write to the default directory.

Solutions:

Tools like nvm or n install Node.js in a way that avoids permission issues for global packages.

Install nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

Install Node.js with nvm:

nvm install --lts
nvm use --lts

Then install Fever CLI:

npm install -g @fevertokens/cli

Option 2: Change npm's Default Directory​

Configure npm to use a different directory. Follow the official npm guide on resolving EACCES permissions errors.

You can prefix the command with sudo, but this is generally discouraged as it can lead to other security risks.

sudo npm install -g @fevertokens/cli
Security Note

Using sudo for npm installations can cause permission issues with future npm commands and is a security risk. We strongly recommend using nvm instead.

Command Not Found​

If your terminal says fever: command not found after installation, it means the directory where npm installs global packages is not in your system's PATH.

Fix:

  1. Find npm's global install location:

    npm get prefix

  2. Add the resulting path to your shell's configuration file:

    For Zsh (macOS default):

    echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
    source ~/.zshrc

    For Bash:

    echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc

  3. Verify the fix:

    fever --version

Node.js Version Issues​

If you see errors about Node.js version compatibility:

Check your version:

node --version

If below v20.x, upgrade:

Using nvm:

nvm install 20
nvm use 20

Or download from: https://nodejs.org/

Updating Fever CLI​

To update to the latest version:

npm install -g @fevertokens/cli@latest

Check the new version:

fever --version
Stay Updated

Fever CLI is actively developed with frequent updates. Check for updates regularly to get the latest features and improvements!

View releases: GitHub Releases

Uninstalling​

If you need to uninstall Fever CLI:

npm uninstall -g @fevertokens/cli

This removes the CLI while preserving your local .fever directory and configurations.

Quick Reference​

# Install
npm install -g @fevertokens/cli

# Verify
fever --version
fever auth status

# Update
npm install -g @fevertokens/cli@latest

# Uninstall
npm uninstall -g @fevertokens/cli

# Get help
fever --help
fever <command> --help

What's Included​

After installation, you have access to all Fever CLI commands:

# Core Commands
fever auth login              # Authenticate with platform
fever projects create         # Create projects
fever compile --all          # Compile contracts
fever apply -f manifest.yaml  # Deploy from manifest
fever artifacts sync          # Smart artifact sync

# Network Management
fever networks                # List networks
fever networks select         # Interactive selection
fever networks add --local    # Add localhost

# Development Tools
fever node                    # Start local blockchain
fever wallets generate        # Generate secure wallets

# Utilities
fever install                 # Install dependencies (auto-detect pm)

See Command Reference for complete documentation.

System Requirements​

  • Operating System: macOS, Linux, or Windows (WSL recommended)
  • Memory: 4GB RAM minimum, 8GB recommended
  • Disk Space: 500MB for Fever CLI and dependencies
  • Network: Internet connection for platform features

Next Steps​

Choose your path:

🎯 For Quick Learners​

→ Start the Quickstart Tutorial

Deploy a complete system in 15 minutes.

📚 For Methodical Learners​

→ Begin Getting Started Guide

Step-by-step first deployment in 10 minutes.

📖 For Documentation Readers​

→ Read the Manifest Guide

Understand the three deployment types.

Ready? Let's start deploying smarter! 🔥

fever auth login