Установка

Установите Bun с помощью npm, Homebrew, Docker или официального скрипта.

Обзор

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

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

Установка

macOS и Linux

curl

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

Пользователям Linux: для установки Bun вам понадобится пакет unzip (sudo apt install unzip). Рекомендуем использовать ядро версии 5.6 или выше. Bun также работает на ядрах вплоть до версии 3.10 (RHEL 7), обеспечивая совместимость с новыми системными вызовами. Чтобы проверить версию ядра, используйте uname -r.

Windows

PowerShell

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

Для работы Bun требуется Windows 10 версии 1809 или более поздней.

Чтобы получить помощь и пообщаться, присоединяйтесь к каналу #windows в Discord.

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

npm

npm install -g bun # the last `npm` command you'll ever need

Homebrew

brew install oven-sh/bun/bun

Scoop

scoop install bun

Docker

Bun предоставляет образ Docker для Linux x64 и ARM64.

Docker

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

Варианты образов

Bun также публикует варианты образов для разных операционных систем:

Docker

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

Чтобы убедиться, что Bun установлен успешно, откройте новое окно терминала и выполните:

terminal

bun --version
# Output: 1.x.y

# See the precise commit of `oven-sh/bun` that you're using
bun --revision
# Output: 1.x.y+b7982ac13189

Если Bun установлен, но вы видите ошибку command not found, возможно, вам нужно вручную добавить каталог установки (~/.bun/bin) в PATH.

Добавление Bun в PATH

macOS и Linux

Узнайте, какую оболочку вы используете

terminal

echo $SHELL
# /bin/zsh  or /bin/bash or /bin/fish

Откройте файл конфигурации оболочки

Для bash: ~/.bashrc
Для zsh: ~/.zshrc
Для fish: ~/.config/fish/config.fish

Добавьте каталог Bun в PATH

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

terminal

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

Перезагрузите конфигурацию оболочки

terminal

source ~/.bashrc  # or ~/.zshrc

Windows

Убедитесь, что двоичный файл bun установлен правильно

terminal

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

Если команда выполняется успешно, но bun --version не распознаётся, значит, bun отсутствует в системном PATH. Чтобы исправить это, откройте терминал PowerShell и выполните следующую команду:

terminal

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

Перезапустите терминал

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

terminal

bun --version

Обновление

После установки двоичный файл может обновить себя самостоятельно:

terminal

bun upgrade

Пользователям Homebrew
Во избежание конфликтов с Homebrew используйте вместо этого brew upgrade bun.

Пользователям Scoop
Во избежание конфликтов с Scoop используйте вместо этого scoop update bun.

Канареечные сборки

-> Просмотреть канареечную сборку

Bun автоматически выпускает непроверенную канареечную сборку после каждого коммита в main. Чтобы обновиться до последней канареечной сборки:

terminal

# Upgrade to latest canary
bun upgrade --canary

# Switch back to stable
bun upgrade --stable

Используйте канареечную сборку, чтобы проверить новые функции и исправления ошибок до их появления в стабильном выпуске. Чтобы помочь команде Bun быстрее исправлять ошибки, канареечные сборки автоматически отправляют отчёты о сбоях.

Установка более старых версий

Поскольку Bun — это один двоичный файл, для установки старых версий достаточно повторно запустить скрипт установки, указав нужную версию.

Linux и macOS

Чтобы установить определённую версию, передайте скрипту установки тег git:

terminal

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

Windows

В Windows передайте номер версии скрипту установки PowerShell:

PowerShell

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

Прямая загрузка

Чтобы скачать двоичные файлы Bun напрямую, посетите страницу выпусков на GitHub.

Загрузка последней версии

Linux x64

glibc, Nehalem или новее

Linux ARM64

Системы Linux ARM64

Windows x64

Nehalem или новее

Windows ARM64

Windows на ARM (Snapdragon и т. д.)

macOS ARM64

Apple Silicon (M1/M2/M3)

macOS x64

Компьютеры Mac с процессорами Intel

Двоичные файлы musl

Для дистрибутивов без glibc (Alpine Linux, Void Linux):

Для двоичных файлов Bun с glibc требуется glibc версии 2.17 или новее. Если вы столкнулись с ошибкой вроде bun: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_... not found, попробуйте использовать двоичный файл musl. Скрипт установки Bun автоматически выбирает подходящий двоичный файл для вашей системы.

Требования к процессору

Bun поставляется в виде одного двоичного файла x64 для каждой платформы. Он рассчитан на микроархитектуру Nehalem (SSE4.2) и во время выполнения выбирает пути кода AVX2/AVX-512, если процессор их поддерживает, поэтому отдельную загрузку «базовой» версии выбирать не нужно.

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

Bun не поддерживает процессоры x64 без расширения SSE4.2. Для Bun требуется macOS 13.0 или новее. Ресурсы выпуска -baseline и пакеты npm @oven/bun-*-x64-baseline сохранены в качестве псевдонимов единственного двоичного файла x64 для обратной совместимости со старыми скриптами установки.

Удаление

Чтобы удалить Bun из системы:

macOS и Linux

terminal

rm -rf ~/.bun

Windows

PowerShell

powershell -c ~\.bun\uninstall.ps1

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

npm

npm uninstall -g bun

Homebrew

brew uninstall bun

Scoop

scoop uninstall bun