Visão Geral

O Bun é distribuído como um único executável sem dependências. Você pode instalá-lo via script, gerenciador de pacotes ou Docker em macOS, Linux e Windows.

Aviso

Após a instalação, verifique com bun --version e bun --revision.

Instalação

macOS & Linux

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

Aviso

Usuários Linux - O pacote unzip é necessário para instalar o Bun. Use sudo apt install unzip para instalar o pacote unzip. A versão do kernel 5.6 ou superior é fortemente recomendada, mas o mínimo é 5.1. Use uname -r para verificar a versão do Kernel.

Windows

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

WARNING

O Bun requer Windows 10 versão 1809 ou posterior.

Para suporte e discussão, junte-se ao canal #windows no nosso Discord.

Gerenciadores de Pacotes

npm install -g bun # o último comando `npm` que você precisará

brew install oven-sh/bun/bun

scoop install bun

Docker

O Bun fornece uma imagem Docker que suporta Linux x64 e arm64.

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

Variantes de Imagem

Também existem variantes de imagem para diferentes sistemas operacionais:

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

Para verificar se o Bun foi instalado com sucesso, abra uma nova janela de terminal e execute:

bun --version
# Saída: 1.x.y

# Veja o commit exato do `oven-sh/bun` que você está usando
bun --revision
# Saída: 1.x.y+b7982ac13189

WARNING

Se você instalou o Bun mas está vendo um erro command not found, pode ser necessário adicionar manualmente o diretório de instalação (~/.bun/bin) ao seu PATH.

Adicionar o Bun ao seu PATH

macOS & Linux

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

Abra o arquivo de configuração do seu shell

• Para bash: ~/.bashrc
• Para zsh: ~/.zshrc
• Para fish: ~/.config/fish/config.fish

Adicione o diretório do Bun ao PATH

Adicione esta linha ao seu arquivo de configuração:

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

Recarregue a configuração do seu shell

source ~/.bashrc  # ou ~/.zshrc

Windows

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

Se o comando executar com sucesso mas bun --version não for reconhecido, significa que o bun não está no PATH do seu sistema. Para corrigir isso, abra um terminal PowerShell e execute o seguinte comando:

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

Reinicie seu terminal

Após executar o comando, reinicie seu terminal e teste com bun --version

bun --version

---

Atualização

Uma vez instalado, o binário pode se atualizar:

bun upgrade

---

Builds Canary

-> Ver build canary

O Bun automaticamente lança uma build canary (não testada) a cada commit na main. Para atualizar para a build canary mais recente:

# Atualiza para a canary mais recente
bun upgrade --canary

# Volta para a estável
bun upgrade --stable

A build canary é útil para testar novos recursos e correções de bugs antes de serem lançados em uma build estável. Para ajudar a equipe do Bun a corrigir bugs mais rapidamente, builds canary automaticamente enviam relatórios de crash para a equipe do Bun.

---

Instalando Versões Antigas

Como o Bun é um único binário, você pode instalar versões antigas executando novamente o script instalador com uma versão específica.

Linux & macOS

Para instalar uma versão específica, passe a tag git para o script de instalação:

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

Windows

No Windows, passe o número da versão para o script de instalação do PowerShell:

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

---

Downloads Diretos

Para baixar os binários do Bun diretamente, visite a página de releases no GitHub.

Downloads da Versão Mais Recente

Binário Linux x64 padrão

Para CPUs mais antigas sem AVX2

Binário Windows padrão

Para CPUs mais antigas sem AVX2

Apple Silicon (M1/M2/M3)

Macs Intel

Sistemas ARM64 Linux

Binários Musl

Para distribuições sem glibc (Alpine Linux, Void Linux):

• Linux x64 musl
• Linux x64 musl baseline
• Linux ARM64 musl

TIP

Se você encontrar um erro como bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found, tente usar o binário musl. O script de instalação do Bun automaticamente escolhe o binário correto para seu sistema.

---

Requisitos de CPU

O Bun tem requisitos específicos de CPU baseados no binário que você está usando:

Builds Padrão

Binários x64 têm como alvo a arquitetura de CPU Haswell (instruções AVX e AVX2 necessárias)

Plataforma	Requisito Intel	Requisito AMD
x64	Haswell (4ª geração Core) ou mais recente	Excavator ou mais recente

Builds Baseline

Binários x64-baseline têm como alvo a arquitetura Nehalem para CPUs mais antigas

Plataforma	Requisito Intel	Requisito AMD
x64-baseline	Nehalem (1ª geração Core) ou mais recente	Bulldozer ou mais recente

WARNING

Builds baseline são mais lentas que builds regulares. Use-as apenas se encontrar um erro "Illegal Instruction".

::: note O Bun não suporta CPUs mais antigas que o alvo baseline, que requer a extensão SSE4.2. macOS requer versão 13.0 ou posterior. :::

Desinstalar

Para remover o Bun do seu sistema:

macOS & Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

Gerenciadores de Pacotes

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun