Übersicht

Bun wird als einzelne, abhängigkeitfreie ausführbare Datei ausgeliefert. Sie können es über Skript, Paketmanager oder Docker unter macOS, Linux und Windows installieren.

Warnung

Überprüfen Sie nach der Installation mit bun --version und bun --revision.

Installation

macOS & Linux

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

Warnung

Linux-Benutzer – Das unzip-Paket ist erforderlich, um Bun zu installieren. Verwenden Sie sudo apt install unzip, um das unzip-Paket zu installieren. Kernel-Version 5.6 oder höher wird dringend empfohlen, das Minimum ist 5.1. Verwenden Sie uname -r, um die Kernel-Version zu überprüfen.

Windows

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

WARNING

Bun erfordert Windows 10 Version 1809 oder später.

Für Support und Diskussion treten Sie dem #windows-Kanal auf unserem Discord bei.

Paketmanager

npm install -g bun # der letzte `npm`-Befehl, den Sie jemals benötigen werden

brew install oven-sh/bun/bun

scoop install bun

Docker

Bun stellt ein Docker-Image bereit, das sowohl Linux x64 als auch arm64 unterstützt.

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

Image-Varianten

Es gibt auch Image-Varianten für verschiedene Betriebssysteme:

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

Um zu überprüfen, ob Bun erfolgreich installiert wurde, öffnen Sie ein neues Terminalfenster und führen Sie aus:

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

# Sehen Sie den genauen Commit von `oven-sh/bun`, den Sie verwenden
bun --revision
# Ausgabe: 1.x.y+b7982ac13189

WARNING

Wenn Sie Bun installiert haben, aber einen command not found-Fehler sehen, müssen Sie möglicherweise das Installationsverzeichnis (~/.bun/bin) manuell zu Ihrem PATH hinzufügen.

Bun zu Ihrem PATH hinzufügen

macOS & Linux

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

Öffnen Sie Ihre Shell-Konfigurationsdatei

• Für bash: ~/.bashrc
• Für zsh: ~/.zshrc
• Für fish: ~/.config/fish/config.fish

Fügen Sie das Bun-Verzeichnis zum PATH hinzu

Fügen Sie diese Zeile zu Ihrer Konfigurationsdatei hinzu:

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

Laden Sie Ihre Shell-Konfiguration neu

source ~/.bashrc  # oder ~/.zshrc

Windows

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

Wenn der Befehl erfolgreich ausgeführt wird, aber bun --version nicht erkannt wird, bedeutet dies, dass sich bun nicht im System-PATH befindet. Um dies zu beheben, öffnen Sie ein Powershell-Terminal und führen Sie den folgenden Befehl aus:

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

Starten Sie Ihr Terminal neu

Nachdem Sie den Befehl ausgeführt haben, starten Sie Ihr Terminal neu und testen Sie mit bun --version

bun --version

---

Aktualisierung

Einmal installiert, kann sich die Binärdatei selbst aktualisieren:

bun upgrade

---

Canary-Builds

-> Canary-Build anzeigen

Bun veröffentlicht automatisch einen (ungetesteten) Canary-Build bei jedem Commit auf main. Um auf den neuesten Canary-Build zu aktualisieren:

# Auf neuesten Canary aktualisieren
bun upgrade --canary

# Zurück zu Stable wechseln
bun upgrade --stable

Der Canary-Build ist nützlich, um neue Funktionen und Fehlerbehebungen zu testen, bevor sie in einem Stable-Build veröffentlicht werden. Um dem Bun-Team zu helfen, Fehler schneller zu beheben, laden Canary-Builds automatisch Absturzberichte an Buns Team hoch.

---

Ältere Versionen installieren

Da Bun eine einzelne Binärdatei ist, können Sie ältere Versionen installieren, indem Sie das Installerskript mit einer bestimmten Version erneut ausführen.

Linux & macOS

Um eine bestimmte Version zu installieren, übergeben Sie das Git-Tag an das Installerskript:

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

Windows

Unter Windows übergeben Sie die Versionsnummer an das PowerShell-Installerskript:

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

---

Direkte Downloads

Um Bun-Binärdateien direkt herunterzuladen, besuchen Sie die Releases-Seite auf GitHub.

Downloads der neuesten Version

Standard Linux x64-Binärdatei

Für ältere CPUs ohne AVX2

Standard Windows-Binärdatei

Für ältere CPUs ohne AVX2

Apple Silicon (M1/M2/M3)

Intel Macs

ARM64 Linux-Systeme

Musl-Binärdateien

Für Distributionen ohne glibc (Alpine Linux, Void Linux):

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

TIP

Wenn Sie auf einen Fehler wie bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found stoßen, versuchen Sie die musl-Binärdatei. Buns Installationskript wählt automatisch die richtige Binärdatei für Ihr System aus.

---

CPU-Anforderungen

Bun hat spezifische CPU-Anforderungen basierend auf der Binärdatei, die Sie verwenden:

Standard-Builds

x64-Binärdateien zielen auf die Haswell-CPU-Architektur (AVX- und AVX2-Anweisungen erforderlich)

Plattform	Intel-Anforderung	AMD-Anforderung
x64	Haswell (4. Gen Core) oder neuer	Excavator oder neuer

Baseline-Builds

x64-baseline-Binärdateien zielen auf die Nehalem-Architektur für ältere CPUs

Plattform	Intel-Anforderung	AMD-Anforderung
x64-baseline	Nehalem (1. Gen Core) oder neuer	Bulldozer oder neuer

WARNING

Baseline-Builds sind langsamer als reguläre Builds. Verwenden Sie sie nur, wenn Sie auf einen "Illegal Instruction"-Fehler stoßen.

::: note Bun unterstützt keine CPUs, die älter als das Baseline-Ziel sind, das die SSE4.2-Erweiterung erfordert. macOS erfordert Version 13.0 oder später. :::

Deinstallation

So entfernen Sie Bun von Ihrem System:

macOS & Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

Paketmanager

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun