Обзор

Bun поставляется как единый исполняемый файл без зависимостей. Вы можете установить его через скрипт, менеджер пакетов или Docker на macOS, Linux и Windows.

Предупреждение

После установки проверьте с помощью bun --version и bun --revision.

Установка

macOS и Linux

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

Предупреждение

Пользователи Linux — пакет unzip требуется для установки Bun. Используйте 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 или новее.

Для поддержки и обсуждения присоединяйтесь к каналу #windows на нашем Discord.

Менеджеры пакетов

npm install -g bun # последняя команда `npm`, которая вам понадобится

brew install oven-sh/bun/bun

scoop install bun

Docker

Bun предоставляет образ Docker, поддерживающий Linux x64 и arm64.

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

Добавьте директорию Bun в PATH

Добавьте эту строку в файл конфигурации:

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 автоматически выпускает (нетестированную) canary-сборку на каждый коммит в main. Для обновления до последней 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

Для старых CPU без AVX2

Стандартный бинарный файл Windows

Для старых CPU без AVX2

Apple Silicon (M1/M2/M3)

Intel Macs

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 сборки нацелены на архитектуру CPU Haswell (требуются инструкции AVX и AVX2)

Платформа	Требование Intel	Требование AMD
x64	Haswell (4-е поколение Core) или новее	Excavator или новее

Baseline сборки

x64-baseline сборки нацелены на архитектуру Nehalem для старых CPU

Платформа	Требование Intel	Требование AMD
x64-baseline	Nehalem (1-е поколение Core) или новее	Bulldozer или новее

WARNING

Baseline сборки медленнее обычных сборок. Используйте их только если вы столкнулись с ошибкой "Illegal Instruction".

::: note Bun не поддерживает CPU старше целевой baseline, которая требует расширение 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