Visión General

Bun se distribuye como un ejecutable único sin dependencias. Puedes instalarlo vía script, administrador de paquetes o Docker en macOS, Linux y Windows.

Advertencia

Después de la instalación, verifica con bun --version y bun --revision.

Instalación

macOS y Linux

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

Advertencia

Usuarios de Linux — El paquete unzip es necesario para instalar Bun. Usa sudo apt install unzip para instalar el paquete unzip. Se recomienda encarecidamente la versión del kernel 5.6 o superior, pero el mínimo es 5.1. Usa uname -r para verificar la versión del kernel.

Windows

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

WARNING

  Bun requiere Windows 10 versión 1809 o posterior.

Para soporte y discusión, únete al canal #windows en nuestro Discord.

Administradores de Paquetes

npm install -g bun # el último comando `npm` que necesitarás

brew install oven-sh/bun/bun

scoop install bun

Docker

Bun proporciona una imagen de Docker que soporta tanto Linux x64 como arm64.

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

Variantes de Imagen

También hay variantes de imagen para diferentes sistemas operativos:

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

Para verificar que Bun se instaló correctamente, abre una nueva ventana de terminal y ejecuta:

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

# Ver el commit preciso de `oven-sh/bun` que estás usando
bun --revision
# Salida: 1.x.y+b7982ac13189

WARNING

Si has instalado Bun pero ves un error command not found, es posible que debas agregar manualmente el directorio de instalación (~/.bun/bin) a tu PATH.

Agregar Bun a tu PATH

macOS y Linux

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

Abre tu archivo de configuración de shell

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

Agrega el directorio de Bun al PATH

Agrega esta línea a tu archivo de configuración:

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

Recarga tu configuración de shell

source ~/.bashrc  # o ~/.zshrc

Windows

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

Si el comando se ejecuta correctamente pero bun --version no es reconocido, significa que bun no está en el PATH de tu sistema. Para solucionarlo, abre una terminal de Powershell y ejecuta el siguiente comando:

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

Reinicia tu terminal

Después de ejecutar el comando, reinicia tu terminal y prueba con bun --version

bun --version

---

Actualización

Una vez instalado, el binario puede actualizarse a sí mismo:

bun upgrade

---

Compilaciones Canary

-> Ver compilación canary

Bun automáticamente publica una compilación canary (no probada) en cada commit a main. Para actualizar a la última compilación canary:

# Actualizar a la última canary
bun upgrade --canary

# Volver a estable
bun upgrade --stable

La compilación canary es útil para probar nuevas características y correcciones de errores antes de que se publiquen en una compilación estable. Para ayudar al equipo de Bun a corregir errores más rápido, las compilaciones canary suben automáticamente informes de fallas al equipo de Bun.

---

Instalar Versiones Anteriores

Dado que Bun es un solo binario, puedes instalar versiones anteriores volviendo a ejecutar el script de instalador con una versión específica.

Linux y macOS

Para instalar una versión específica, pasa la etiqueta de git al script de instalación:

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

Windows

En Windows, pasa el número de versión al script de instalación de PowerShell:

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

---

Descargas Directas

Para descargar los binarios de Bun directamente, visita la página de releases en GitHub.

Descargas de la Última Versión

Binario estándar Linux x64

Para CPUs antiguas sin AVX2

Binario estándar Windows

Para CPUs antiguas sin AVX2

Apple Silicon (M1/M2/M3)

Macs Intel

Sistemas ARM64 Linux

Binarios Musl

Para distribuciones sin glibc (Alpine Linux, Void Linux):

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

TIP

Si encuentras un error como bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found, intenta usar el binario musl. El script de instalación de Bun elige automáticamente el binario correcto para tu sistema.

---

Requisitos de CPU

Bun tiene requisitos específicos de CPU según el binario que estés usando:

Compilaciones Estándar

Los binarios x64 tienen como objetivo la arquitectura de CPU Haswell (se requieren instrucciones AVX y AVX2)

Plataforma	Requisito Intel	Requisito AMD
x64	Haswell (4ta gen Core) o posterior	Excavator o posterior

Compilaciones Baseline

Los binarios x64-baseline tienen como objetivo la arquitectura Nehalem para CPUs antiguas

Plataforma	Requisito Intel	Requisito AMD
x64-baseline	Nehalem (1ra gen Core) o posterior	Bulldozer o posterior

WARNING

Las compilaciones baseline son más lentas que las compilaciones regulares. Úsalas solo si encuentras un error "Illegal Instruction".

::: note Bun no soporta CPUs anteriores al objetivo baseline, que requiere la extensión SSE4.2. macOS requiere versión 13.0 o posterior. :::

Desinstalar

Para eliminar Bun de tu sistema:

macOS y Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

Administradores de Paquetes

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun