BLOG POSTS

MangoHost Blog / How to Install and Use Homebrew on Linux

How to Install and Use Homebrew on Linux

Homebrew, originally designed for macOS, has extended its reach to Linux systems through Homebrew on Linux (formerly known as Linuxbrew). This powerful package manager allows developers to install and manage software packages in their home directory without requiring root privileges, making it particularly valuable for shared hosting environments, development servers, and systems where you don’t have admin access. In this guide, you’ll learn how to install Homebrew on Linux, understand its core functionality, explore real-world use cases, and master troubleshooting techniques to resolve common issues.

How Homebrew Works on Linux

Unlike traditional Linux package managers that require root access and install packages system-wide, Homebrew on Linux operates within your user directory. It creates a /home/linuxbrew/.linuxbrew directory (or ~/.linuxbrew for single-user installations) where all packages, dependencies, and configurations are stored.

The system works by:

Downloading source code or pre-compiled binaries
Resolving dependencies automatically
Installing everything in isolated directories
Creating symbolic links to make commands available in your PATH
Maintaining a local package database for updates and removals

This approach means you can install different versions of software alongside system packages without conflicts. Homebrew uses “formulae” (Ruby scripts) to define how packages should be built and installed, and “taps” to extend the available package repository.

Prerequisites and System Requirements

Before installing Homebrew on Linux, ensure your system meets these requirements:

Component	Requirement	Notes
Linux Distribution	Most modern distributions	Ubuntu, CentOS, Debian, Fedora, etc.
Architecture	x86_64, ARM64	32-bit systems not supported
Disk Space	Minimum 1GB free	More recommended for multiple packages
Network Access	Internet connection	Required for downloading packages

Install the essential build tools first:

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install build-essential curl file git

# CentOS/RHEL/Fedora
sudo yum groupinstall "Development Tools"
sudo yum install curl file git

# Or for newer versions:
sudo dnf groupinstall "Development Tools"
sudo dnf install curl file git

Step-by-Step Installation Guide

The installation process is straightforward but requires attention to detail. Here’s the complete walkthrough:

Method 1: Official Installation Script

Run the official installation script, which handles most of the setup automatically:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

The script will:

Download and install Homebrew to /home/linuxbrew/.linuxbrew
Install necessary dependencies
Set up initial configuration
Provide instructions for adding Homebrew to your PATH

Method 2: Manual Installation

For more control over the installation process:

# Create the homebrew directory
sudo mkdir -p /home/linuxbrew/.linuxbrew
sudo chown -R $(whoami) /home/linuxbrew/.linuxbrew

# Clone the repository
git clone https://github.com/Homebrew/brew /home/linuxbrew/.linuxbrew/Homebrew

# Create necessary directories
mkdir -p /home/linuxbrew/.linuxbrew/bin
ln -s /home/linuxbrew/.linuxbrew/Homebrew/bin/brew /home/linuxbrew/.linuxbrew/bin/brew

Configure Your Shell Environment

Add Homebrew to your PATH by modifying your shell configuration file:

# For Bash (add to ~/.bashrc or ~/.bash_profile)
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc

# For Zsh (add to ~/.zshrc)
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.zshrc

# For Fish (add to ~/.config/fish/config.fish)
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.config/fish/config.fish

# Reload your shell configuration
source ~/.bashrc  # or ~/.zshrc

Verify Installation

Test your installation with these commands:

# Check Homebrew version
brew --version

# Run diagnostic check
brew doctor

# Update package lists
brew update

Essential Commands and Usage

Master these fundamental Homebrew commands for daily usage:

# Package Management
brew install package_name          # Install a package
brew uninstall package_name        # Remove a package
brew upgrade package_name          # Update specific package
brew upgrade                       # Update all packages
brew list                         # List installed packages
brew search keyword               # Search for packages

# Information and Maintenance
brew info package_name            # Show package information
brew deps package_name            # Show package dependencies
brew cleanup                      # Remove old package versions
brew doctor                       # Check for configuration issues
brew config                       # Show Homebrew configuration

# Services Management
brew services start service_name   # Start a service
brew services stop service_name    # Stop a service
brew services restart service_name # Restart a service
brew services list                 # List all services

Real-World Examples and Use Cases

Development Environment Setup

Here’s how to set up a complete development environment using Homebrew:

# Install programming languages
brew install python3 node ruby go rust

# Install development tools
brew install git vim neovim tmux htop

# Install databases
brew install postgresql mysql redis mongodb-community

# Install web servers
brew install nginx apache2

# Start services
brew services start postgresql
brew services start redis

Data Science Stack

Create a data science environment without conflicting with system packages:

# Install Python and R
brew install python3 r

# Install scientific computing tools
brew install jupyter numpy scipy matplotlib pandas

# Install additional tools
brew install pandoc graphviz imagemagick

DevOps and System Administration

Install modern system administration tools:

# Container and orchestration tools
brew install docker kubectl helm terraform

# Monitoring and networking
brew install wireshark nmap netcat

# File and text processing
brew install jq yq ripgrep fd bat exa

Comparison with Other Package Managers

Feature	Homebrew	APT/YUM	Snap	Flatpak
Root Access Required	No	Yes	Yes	No (user install)
Installation Location	User directory	System-wide	System-wide	User/System
Package Isolation	Moderate	Low	High	High
Dependency Management	Excellent	Good	Bundled	Bundled
Package Variety	High (dev-focused)	Very High	Medium	Medium (GUI apps)
Update Speed	Fast	Variable	Fast	Fast

Common Issues and Troubleshooting

Permission Errors

If you encounter permission issues during installation:

# Fix ownership of Homebrew directory
sudo chown -R $(whoami) /home/linuxbrew/.linuxbrew

# Ensure proper permissions
chmod -R u+w /home/linuxbrew/.linuxbrew

PATH Configuration Issues

When Homebrew commands aren’t found:

# Check if Homebrew is in PATH
echo $PATH | grep linuxbrew

# Manually add to current session
export PATH="/home/linuxbrew/.linuxbrew/bin:$PATH"

# Check shell configuration files
grep -r "brew" ~/.bashrc ~/.zshrc ~/.profile

Dependency Resolution Problems

When packages fail to install due to missing dependencies:

# Install missing system dependencies
# Ubuntu/Debian
sudo apt-get install build-essential

# CentOS/RHEL
sudo yum groupinstall "Development Tools"

# Run Homebrew's dependency installer
brew install gcc

# Force reinstall problematic packages
brew reinstall --build-from-source package_name

Network and Download Issues

For problems downloading packages or updates:

# Check connectivity to Homebrew servers
curl -I https://formulae.brew.sh

# Clear Homebrew cache
brew cleanup --prune=all

# Update Homebrew itself
brew update --force

# Use different mirror (if available)
export HOMEBREW_BOTTLE_DOMAIN="https://mirror.example.com/homebrew"

Best Practices and Security Considerations

Security Best Practices

Regularly update Homebrew and installed packages to get security patches
Review package sources and maintainers before installing unfamiliar software
Use official taps when possible, be cautious with third-party taps
Monitor installed services and their network exposure
Keep your system’s base packages updated alongside Homebrew packages

Performance Optimization

# Set environment variables for better performance
export HOMEBREW_NO_AUTO_UPDATE=1        # Disable auto-update during install
export HOMEBREW_NO_ANALYTICS=1          # Disable analytics
export HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS=7  # Auto-cleanup frequency

# Add to your shell configuration file
echo 'export HOMEBREW_NO_ANALYTICS=1' >> ~/.bashrc

Storage Management

# Monitor disk usage
du -sh /home/linuxbrew/.linuxbrew

# Regular cleanup routine
brew cleanup --prune=30    # Remove downloads older than 30 days
brew autoremove            # Remove unused dependencies

# List largest packages
brew list --formula | xargs -I {} sh -c 'echo "{}: $(brew --prefix {})" | head -20'

Advanced Configuration and Customization

Creating Custom Formulae

You can create custom packages for internal tools or specific versions:

# Create a new tap (package repository)
brew tap-new your-username/your-tap

# Generate a formula template
brew create https://github.com/example/project/archive/v1.0.tar.gz

Using Multiple Homebrew Installations

For testing or isolation purposes, you can maintain multiple Homebrew installations:

# Install to custom location
git clone https://github.com/Homebrew/brew ~/homebrew-test
echo 'export PATH="$HOME/homebrew-test/bin:$PATH"' >> ~/.bashrc_test

# Switch between installations
alias brew-main='/home/linuxbrew/.linuxbrew/bin/brew'
alias brew-test='~/homebrew-test/bin/brew'

Integration with CI/CD and Automation

Homebrew works excellently in automated environments. Here’s a GitHub Actions example:

name: Setup Development Environment
on: [push, pull_request]

jobs:
  setup:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    
    - name: Install Homebrew
      run: |
        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
        echo "/home/linuxbrew/.linuxbrew/bin" >> $GITHUB_PATH
    
    - name: Install dependencies
      run: |
        brew install node python3 postgresql
        brew services start postgresql
    
    - name: Run tests
      run: |
        npm test

For more information about Homebrew on Linux, visit the official Homebrew documentation and the Homebrew GitHub repository. The Homebrew Formulae website provides a searchable database of all available packages with installation instructions and dependency information.

This article incorporates information and material from various online sources. We acknowledge and appreciate the work of all original authors, publishers, and websites. While every effort has been made to appropriately credit the source material, any unintentional oversight or omission does not constitute a copyright infringement. All trademarks, logos, and images mentioned are the property of their respective owners. If you believe that any content used in this article infringes upon your copyright, please contact us immediately for review and prompt action.

This article is intended for informational and educational purposes only and does not infringe on the rights of the copyright owners. If any copyrighted material has been used without proper credit or in violation of copyright laws, it is unintentional and we will rectify it promptly upon notification. Please note that the republishing, redistribution, or reproduction of part or all of the contents in any form is prohibited without express written permission from the author and website owner. For permissions or further inquiries, please contact us.