Manual installation

You can install Biome to your machine to use like any other command line tool. This can be a great choice if you need to run this manually: for instance, if you use a code editor that does not have a Biome plugin, or if you intend to use this in shell scripts or another local tool to automate processing of source code files, or if you intend to have an AI coding tool execute this tool.

If you are using Biome in a CI/CD pipeline, you should install it directly into the project using a Node.js package manager (npm, pnpm, etc) and abandon this manual option.

Supported Architectures

You have to pick the correct binary for your CPU architecture for Biome work. The following table should help you do so.

CPU Architecture	Windows	macOS	Linux	Linux (musl)
`arm64`	`win32-arm64`	`darwin-arm64` (M1 or newer)	`linux-arm64`	`linux-arm64-musl`
`x64`	`win32-x64`	`darwin-x64`	`linux-x64`	`linux-x64-musl`

Windows

Install Biome either using the winget native package manager for Windows, or a download:

Winget

Native package manager for Windows:

1
# Windows (x86_64, Powershell)
2
winget install BiomeJS.Biome

Download

Download via Latest CLI release on GitHub or the following shell command:

1
# Windows (x86_64, Powershell)
2
Invoke-WebRequest -Uri "https://github.com/biomejs/biome/releases/download/@biomejs/biome@2.3.7/biome-win32-x64.exe" -OutFile "%USERPROFILE%Downloadsinariesiome.exe"

Now you can use Biome by running C:\users\<your_username>\Downloads\binaries\biome.exe. Note that this does not register Biome on the PATH var (system or user var), so you cannot call it from within any folder by simply using biome. In order to register it to the PATH, edit the PATH variable using your operating system’s GUI or command line:

Either

Press Windows key + R to open the Run dialog, type sysdm.cpl, and press Enter.
Add the folder in a new line to the User PATH variable (not system PATH).

Open Terminal and run:

1
# Windows (x86_64, Powershell)
2
setx PATH "%PATH%;%USERPROFILE%Downloadsinaries"

This updates the PATH permanently and applies to future terminal sessions. To update the current terminal, run

1
# Windows (x86_64, Powershell)
2
set PATH="%PATH%;%USERPROFILE%Downloadsinaries"

macOS and Linux

Biome is available as a Homebrew formula for macOS and Linux users.

1
brew install biome

Using a published binary

To install Biome, grab the executable for your platform from the latest CLI release on GitHub and give it execution permission.

1
# macOS arm64 (Apple Silicon – M1/M2/M3/M4)
2
curl -L https://github.com/biomejs/biome/releases/download/@biomejs/biome@2.3.7/biome-darwin-arm64 -o biome
3
chmod +x biome
4

5
# macOS x86_64 (Intel Macs)
6
curl -L https://github.com/biomejs/biome/releases/download/@biomejs/biome@2.3.7/biome-darwin-x64 -o biome
7
chmod +x biome
8

9
# Linux x86_64
10
curl -L https://github.com/biomejs/biome/releases/download/@biomejs/biome@2.3.7/biome-linux-x64 -o biome
11
chmod +x biome
12

13
# Linux arm64/aarch64 (Raspberry Pi 64-bit, AWS Graviton, etc.)
14
curl -L https://github.com/biomejs/biome/releases/download/@biomejs/biome@2.3.7/biome-linux-arm64 -o biome
15
chmod +x biome

You can now run Biome with ./biome.

To run it globally from any directory just by typing biome, add it to your PATH. Here are the recommended ways:

Recommended: Move the binary to a directory already in $PATH

1
# Most common choice on both macOS and Linux
2
sudo mv biome /usr/local/bin/biome
3

4
# Alternative (user-local, no sudo needed – preferred on many modern Linux distros)
5
mkdir -p ~/.local/bin
6
mv biome ~/.local/bin/biome

Alternative: Add the current folder to your PATH If you prefer not to move the binary, append the current directory to PATH in your shell configuration file.

macOS (zsh – default since Catalina) – add to ~/.zshrc
Terminal window
```
1
export PATH="$PATH:$(pwd)"
```
macOS (bash) or Linux – add to ~/.bashrc, ~/.zshrc, or equivalent
Terminal window
```
1
export PATH="$PATH:$(pwd)"
```

Then reload your shell:

1
source ~/.zshrc   # or source ~/.bashrc

Now biome works everywhere:

1
biome --version biome format . biome lint .

Docker

Biome publishes official Docker images that support the amd64 and arm64 architectures for all Biome versions starting from v1.7.0.

1
ghcr.io/biomejs/biome:{major}
2
ghcr.io/biomejs/biome:{major}.{minor}
3
ghcr.io/biomejs/biome:{major}.{minor}.{patch}

Here are a couple examples on how to use the Docker image:

1
# Lint files
2
docker run -v $(pwd):/code ghcr.io/biomejs/biome lint
3
docker run -v $(pwd):/code ghcr.io/biomejs/biome lint --write
4

5
# Format files
6
docker run -v $(pwd):/code ghcr.io/biomejs/biome format
7
docker run -v $(pwd):/code ghcr.io/biomejs/biome format --write

Next Steps

Follow our Getting Started guide.