概要

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 バイナリ

AVX2 なしで古い CPU 向け

標準 Windows バイナリ

AVX2 なしで古い CPU 向け

Apple Silicon (M1/M2/M3)

Intel Mac

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