Panoramica

Bun viene distribuito come un singolo eseguibile senza dipendenze. Puoi installarlo tramite script, package manager o Docker su macOS, Linux e Windows.

Avviso

Dopo l'installazione, verifica con bun --version e bun --revision.

Installazione

macOS e Linux

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

Avviso

Utenti Linux — Il pacchetto unzip è richiesto per installare Bun. Usa sudo apt install unzip per installare il pacchetto unzip. La versione del kernel 5.6 o superiore è fortemente raccomandata, ma il minimo è 5.1. Usa uname -r per controllare la versione del kernel.

Windows

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

WARNING

Bun richiede Windows 10 versione 1809 o successiva.

Per supporto e discussione, unisciti al canale #windows sul nostro Discord.

Package Manager

npm install -g bun # l'ultimo comando `npm` di cui avrai bisogno

brew install oven-sh/bun/bun

scoop install bun

Docker

Bun fornisce un'immagine Docker che supporta sia Linux x64 che arm64.

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

Varianti di Immagine

Ci sono anche varianti di immagine per diversi sistemi operativi:

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

Per verificare che Bun sia stato installato correttamente, apri una nuova finestra del terminale ed esegui:

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

# Vedi il commit preciso di `oven-sh/bun` che stai usando
bun --revision
# Output: 1.x.y+b7982ac13189

WARNING

Se hai installato Bun ma vedi un errore command not found, potresti dover aggiungere manualmente la directory di installazione (~/.bun/bin) al tuo PATH.

Aggiungere Bun al tuo PATH

macOS e Linux

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

Apri il tuo file di configurazione della shell

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

Aggiungi la directory di Bun al PATH

Aggiungi questa riga al tuo file di configurazione:

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

Ricarica la tua configurazione della shell

source ~/.bashrc  # o ~/.zshrc

Windows

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

Se il comando viene eseguito con successo ma bun --version non è riconosciuto, significa che bun non è nel PATH del sistema. Per risolvere, apri un terminale Powershell ed esegui il seguente comando:

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

Riavvia il tuo terminale

Dopo aver eseguito il comando, riavvia il terminale e testa con bun --version

bun --version

---

Aggiornamento

Una volta installato, il binario può aggiornarsi da solo:

bun upgrade

---

Build Canary

-> Vedi build canary

Bun rilascia automaticamente una build canary (non testata) ad ogni commit su main. Per aggiornare all'ultima build canary:

# Aggiorna all'ultima canary
bun upgrade --canary

# Torna alla stabile
bun upgrade --stable

La build canary è utile per testare nuove funzionalità e correzioni di bug prima che vengano rilasciate in una build stabile. Per aiutare il team di Bun a correggere i bug più velocemente, le build canary caricano automaticamente i report di crash al team di Bun.

---

Installazione di Versioni Precedenti

Poiché Bun è un singolo binario, puoi installare versioni precedenti rieseguendo lo script di installazione con una versione specifica.

Linux e macOS

Per installare una versione specifica, passa il tag git allo script di installazione:

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

Windows

Su Windows, passa il numero di versione allo script di installazione PowerShell:

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

---

Download Diretti

Per scaricare i binari di Bun direttamente, visita la pagina delle release su GitHub.

Download Ultima Versione

Binario standard Linux x64

Per CPU più vecchie senza AVX2

Binario standard Windows

Per CPU più vecchie senza AVX2

Apple Silicon (M1/M2/M3)

Mac Intel

Sistemi ARM64 Linux

Binari Musl

Per distribuzioni senza glibc (Alpine Linux, Void Linux):

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

TIP

Se incontri un errore come bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found, prova a usare il binario musl. Lo script di installazione di Bun sceglie automaticamente il binario corretto per il tuo sistema.

---

Requisiti CPU

Bun ha requisiti CPU specifici in base al binario che stai usando:

Build Standard

I binari x64 hanno come target l'architettura CPU Haswell (istruzioni AVX e AVX2 richieste)

Piattaforma	Requisito Intel	Requisito AMD
x64	Haswell (Core di 4a gen) o successivo	Excavator o successivo

Build Baseline

I binari x64-baseline hanno come target l'architettura Nehalem per CPU più vecchie

Piattaforma	Requisito Intel	Requisito AMD
x64-baseline	Nehalem (Core di 1a gen) o successivo	Bulldozer o successivo

WARNING

Le build baseline sono più lente delle build regolari. Usale solo se incontri un errore "Illegal Instruction".

::: note Bun non supporta CPU più vecchie del target baseline, che richiede l'estensione SSE4.2. macOS richiede la versione 13.0 o successiva. :::

Disinstallazione

Per rimuovere Bun dal tuo sistema:

macOS e Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

Package Manager

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun