85 lines
		
	
	
		
			4.1 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			85 lines
		
	
	
		
			4.1 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| ---
 | |
| logo: https://brew.sh/assets/img/linuxbrew.png
 | |
| image: https://brew.sh/assets/img/linuxbrew.png
 | |
| redirect_from:
 | |
|   - /linux
 | |
|   - /Linux
 | |
|   - /Linuxbrew
 | |
| ---
 | |
| 
 | |
| # Homebrew on Linux
 | |
| 
 | |
| The Homebrew package manager may be used on Linux and [Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/about). Homebrew was formerly referred to as Linuxbrew when running on Linux or WSL. It can be installed in your home directory, in which case it does not use *sudo*. Homebrew does not use any libraries provided by your host system, except *glibc* and *gcc* if they are new enough. Homebrew can install its own current versions of *glibc* and *gcc* for older distributions of Linux.
 | |
| 
 | |
| [Features](#features), [installation instructions](#install) and [requirements](#requirements) are described below. Terminology (e.g. the difference between a Cellar, Tap, Cask and so forth) is [explained in the documentation](Formula-Cookbook.md#homebrew-terminology).
 | |
| 
 | |
| ## Features
 | |
| 
 | |
| - Can install software to your home directory and so does not require *sudo*
 | |
| - Install software not packaged by your host distribution
 | |
| - Install up-to-date versions of software when your host distribution is old
 | |
| - Use the same package manager to manage your macOS, Linux, and Windows systems
 | |
| 
 | |
| ## Install
 | |
| 
 | |
| Instructions for a supported install of Homebrew on Linux are on the [homepage](https://brew.sh).
 | |
| 
 | |
| The installation script installs Homebrew to `/home/linuxbrew/.linuxbrew` using *sudo* if possible and within your home directory at `~/.linuxbrew` otherwise. Homebrew does not use *sudo* after installation. Using `/home/linuxbrew/.linuxbrew` allows the use of more binary packages (bottles) than installing in your personal home directory.
 | |
| 
 | |
| The prefix `/home/linuxbrew/.linuxbrew` was chosen so that users without admin access can ask an admin to create a `linuxbrew` role account and still benefit from precompiled binaries. If you do not yourself have admin privileges, consider asking your admin staff to create a `linuxbrew` role account for you with home directory set to `/home/linuxbrew`.
 | |
| 
 | |
| Follow the *Next steps* instructions to add Homebrew to your `PATH` and to your bash shell profile script, either `~/.profile` on Debian/Ubuntu or `~/.bash_profile` on CentOS/Fedora/Red Hat.
 | |
| 
 | |
| ```sh
 | |
| test -d ~/.linuxbrew && eval "$(~/.linuxbrew/bin/brew shellenv)"
 | |
| test -d /home/linuxbrew/.linuxbrew && eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
 | |
| test -r ~/.bash_profile && echo "eval \"\$($(brew --prefix)/bin/brew shellenv)\"" >> ~/.bash_profile
 | |
| echo "eval \"\$($(brew --prefix)/bin/brew shellenv)\"" >> ~/.profile
 | |
| ```
 | |
| 
 | |
| You're done! Try installing a package:
 | |
| 
 | |
| ```sh
 | |
| brew install hello
 | |
| ```
 | |
| 
 | |
| If you're using an older distribution of Linux, installing your first package will also install a recent version of *glibc* and *gcc*. Use `brew doctor` to troubleshoot common issues.
 | |
| 
 | |
| ## Requirements
 | |
| 
 | |
| - **GCC** 4.7.0 or newer
 | |
| - **Linux** 2.6.32 or newer
 | |
| - **Glibc** 2.13 or newer
 | |
| - **64-bit x86_64** CPU
 | |
| 
 | |
| To install build tools, paste at a terminal prompt:
 | |
| 
 | |
| - **Debian or Ubuntu**
 | |
| 
 | |
|   ```sh
 | |
|   sudo apt-get install build-essential procps curl file git
 | |
|   ```
 | |
| 
 | |
| - **Fedora, CentOS, or Red Hat**
 | |
| 
 | |
|   ```sh
 | |
|   sudo yum groupinstall 'Development Tools'
 | |
|   sudo yum install procps-ng curl file git
 | |
|   sudo yum install libxcrypt-compat # needed by Fedora 30 and up
 | |
|   ```
 | |
| 
 | |
| ### ARM
 | |
| 
 | |
| Homebrew can run on 32-bit ARM (Raspberry Pi and others) and 64-bit ARM (AArch64), but no binary packages (bottles) are available. Support for ARM is on a best-effort basis. Pull requests are welcome to improve the experience on ARM platforms.
 | |
| 
 | |
| You may need to install your own Ruby using your system package manager, a PPA, or `rbenv/ruby-build` as we no longer distribute a Homebrew Portable Ruby for ARM.
 | |
| 
 | |
| ### 32-bit x86
 | |
| 
 | |
| Homebrew does not currently support 32-bit x86 platforms. It would be possible for Homebrew to work on 32-bit x86 platforms with some effort. An interested and dedicated person could maintain a fork of Homebrew to develop support for 32-bit x86.
 | |
| 
 | |
| ## Homebrew on Linux Community
 | |
| 
 | |
| - [@HomebrewOnLinux on Twitter](https://twitter.com/HomebrewOnLinux)
 | |
| - [Homebrew/discussions (forum)](https://github.com/homebrew/discussions/discussions)
 | 
