概要

Bun は、依存関係のない単一の実行可能ファイルとして提供されます。macOS、Linux、Windows でスクリプト、パッケージマネージャー、または Docker を介してインストールできます。

警告

インストール後、bun --version および bun --revision で確認してください。

インストール

macOS & Linux

curl -fsSL https://bun.com/install | bash

警告

Linux ユーザー - Bun をインストールするには unzip パッケージが必要です。sudo apt install unzip を使用して unzip パッケージをインストールしてください。カーネルバージョン 5.6 以上を強く推奨しますが、最小限は 5.1 です。uname -r を使用してカーネルバージョンを確認してください。

Windows

powershell -c "irm bun.sh/install.ps1|iex"

WARNING

Bun には Windows 10 バージョン 1809 以降が必要です。

サポートとディスカッションについては、Discord の #windows チャンネルに参加してください。

パッケージマネージャー

npm install -g bun # 最後の `npm` コマンド

brew install oven-sh/bun/bun

scoop install bun

Docker

Bun は Linux x64 と arm64 の両方をサポートする Docker イメージを提供しています。

docker pull oven/bun
docker run --rm --init --ulimit memlock=-1:-1 oven/bun

イメージバリアント

異なるオペレーティングシステム向けのイメージバリアントもあります。

docker pull oven/bun:debian
docker pull oven/bun:slim
docker pull oven/bun:distroless
docker pull oven/bun:alpine

Bun が正常にインストールされたことを確認するには、新しいターミナルウィンドウを開いて以下を実行します。

bun --version
# 出力：1.x.y

# 使用中の `oven-sh/bun` の正確なコミットを確認
bun --revision
# 出力：1.x.y+b7982ac13189

WARNING

Bun をインストールしたが command not found エラーが表示される場合は、インストールディレクトリ（~/.bun/bin）を手動で PATH に追加する必要がある場合があります。

Bun を PATH に追加する

macOS & Linux

echo $SHELL
# /bin/zsh または /bin/bash または /bin/fish

シェル設定ファイルを開く

• bash の場合：~/.bashrc
• zsh の場合：~/.zshrc
• fish の場合：~/.config/fish/config.fish

PATH に Bun ディレクトリを追加する

この行を設定ファイルに追加します。

export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

シェル設定をリロードする

source ~/.bashrc  # または ~/.zshrc

Windows

& "$env:USERPROFILE\.bun\bin\bun" --version

コマンドが正常に実行されるが bun --version が認識されない場合は、bun がシステムの PATH にないことを意味します。これを修正するには、Powershell ターミナルを開いて次のコマンドを実行します。

[System.Environment]::SetEnvironmentVariable(
  "Path",
  [System.Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.bun\bin",
  [System.EnvironmentVariableTarget]::User
)

ターミナルを再起動する

コマンドを実行した後、ターミナルを再起動して bun --version でテストします。

bun --version

---

アップグレード

一度インストールすると、バイナリは自分自身をアップグレードできます。

bun upgrade

---

Canary ビルド

-> canary ビルドを表示

Bun は main へのすべてのコミットで自動的に（未テストの）canary ビルドをリリースします。最新の canary ビルドにアップグレードするには：

# 最新の canary にアップグレード
bun upgrade --canary

# 安定版に戻る
bun upgrade --stable

canary ビルドは、安定版ビルドでリリースされる前に新機能とバグ修正をテストするのに役立ちます。Bun チームがバグをより迅速に修正できるよう支援するために、canary ビルドは自動的にクラッシュレポートを Bun チームにアップロードします。

---

古いバージョンのインストール

Bun は単一のバイナリであるため、特定のバージョンでインストーラースクリプトを再実行することで古いバージョンをインストールできます。

Linux & macOS

特定のバージョンをインストールするには、git タグをインストールスクリプトに渡します。

curl -fsSL https://bun.com/install | bash -s "bun-v1.3.3"

Windows

Windows では、PowerShell インストールスクリプトにバージョン番号を渡します。

iex "& {$(irm https://bun.com/install.ps1)} -Version 1.3.3"

---

直接ダウンロード

Bun バイナリを直接ダウンロードするには、GitHub のリリースページ にアクセスしてください。

最新バージョンのダウンロード

Linux x64

標準 Linux x64 バイナリ

Linux x64 ベースライン

AVX2 なしで古い CPU 向け

Windows x64

標準 Windows バイナリ

Windows x64 ベースライン

AVX2 なしで古い CPU 向け

macOS ARM64

Apple Silicon (M1/M2/M3)

macOS x64

Intel Mac

Linux ARM64

ARM64 Linux システム

Musl バイナリ

glibc なしディストリビューション（Alpine Linux、Void Linux）向け。

• Linux x64 musl
• Linux x64 musl ベースライン
• Linux ARM64 musl

TIP

bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found のようなエラーが発生した場合は、musl バイナリを使用してみてください。Bun のインストールスクリプトは、システムに適切なバイナリを自動的に選択します。

---

CPU 要件

Bun は、使用するバイナリに基づいて特定の CPU 要件があります。

標準ビルド

x64 バイナリ は Haswell CPU アーキテクチャ（AVX および AVX2 命令が必要）を対象としています。

プラットフォーム	Intel 要件	AMD 要件
x64	Haswell（第 4 世代 Core）以降	Excavator 以降

ベースラインビルド

x64-baseline バイナリ は古い CPU 向けに Nehalem アーキテクチャを対象としています。

プラットフォーム	Intel 要件	AMD 要件
x64-baseline	Nehalem（第 1 世代 Core）以降	Bulldozer 以降

WARNING

ベースラインビルドは通常のビルドよりも遅いです。「Illegal Instruction」エラーが発生した場合にのみ使用してください。

::: note Bun はベースラインターゲットより古い CPU をサポートしていません。これは SSE4.2 拡張機能を必須としています。macOS はバージョン 13.0 以降が必要です。 :::

アンインストール

システムから Bun を削除するには：

macOS & Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

パッケージマネージャー

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun