개요

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 빌드는 안정 빌드로 릴리스되기 전에 새로운 기능과 버그 수정을 테스트하는 데 유용합니다. 버그를 더 빠르게 수정하는 데 도움을 주기 위해 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 Baseline

AVX2 가 없는 구형 CPU 용

Windows x64

표준 Windows 바이너리

Windows x64 Baseline

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 baseline
• 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 이상

Baseline 빌드

x64-baseline 바이너리 는 구형 CPU 를 위해 Nehalem 아키텍처를 대상으로 합니다.

플랫폼	Intel 요구 사항	AMD 요구 사항
x64-baseline	Nehalem (1 세대 Core) 이상	Bulldozer 이상

WARNING

Baseline 빌드는 일반 빌드보다 느립니다. "Illegal Instruction" 오류가 발생하는 경우에만 사용하세요.

::: note Bun 은 baseline 대상보다 오래된 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