Vue d'ensemble

Bun est distribué sous forme d'un exécutable unique sans dépendance. Vous pouvez l'installer via un script, un gestionnaire de packages ou Docker sur macOS, Linux et Windows.

Avertissement

Après l'installation, vérifiez avec bun --version et bun --revision.

Installation

macOS et Linux

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

Avertissement

Utilisateurs Linux — Le package unzip est requis pour installer Bun. Utilisez sudo apt install unzip pour installer le package unzip. La version du noyau 5.6 ou supérieure est fortement recommandée, mais le minimum est 5.1. Utilisez uname -r pour vérifier la version du noyau.

Windows

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

WARNING

Bun nécessite Windows 10 version 1809 ou ultérieure.

Pour le support et la discussion, veuillez rejoindre le canal #windows sur notre Discord.

Gestionnaires de packages

npm install -g bun # la dernière commande `npm` dont vous aurez besoin

brew install oven-sh/bun/bun

scoop install bun

Docker

Bun fournit une image Docker qui prend en charge à la fois Linux x64 et arm64.

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

Variantes d'image

Il existe également des variantes d'images pour différents systèmes d'exploitation :

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

Pour vérifier que Bun a été installé avec succès, ouvrez une nouvelle fenêtre de terminal et exécutez :

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

# Voir le commit précis de `oven-sh/bun` que vous utilisez
bun --revision
# Sortie : 1.x.y+b7982ac13189

WARNING

Si vous avez installé Bun mais que vous voyez une erreur command not found, vous devrez peut-être ajouter manuellement le répertoire d'installation (~/.bun/bin) à votre PATH.

Ajouter Bun à votre PATH

macOS et Linux

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

Ouvrez votre fichier de configuration de shell

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

Ajoutez le répertoire Bun au PATH

Ajoutez cette ligne à votre fichier de configuration :

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

Rechargez votre configuration de shell

source ~/.bashrc  # ou ~/.zshrc

Windows

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

Si la commande s'exécute avec succès mais que bun --version n'est pas reconnu, cela signifie que bun n'est pas dans le PATH de votre système. Pour corriger cela, ouvrez un terminal Powershell et exécutez la commande suivante :

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

Redémarrez votre terminal

Après avoir exécuté la commande, redémarrez votre terminal et testez avec bun --version

bun --version

---

Mise à niveau

Une fois installé, le binaire peut se mettre à niveau lui-même :

bun upgrade

---

Versions Canary

-> Voir le build canary

Bun publie automatiquement un build canary (non testé) à chaque commit sur main. Pour mettre à niveau vers le dernier build canary :

# Mettre à niveau vers le dernier canary
bun upgrade --canary

# Revenir à la version stable
bun upgrade --stable

Le build canary est utile pour tester les nouvelles fonctionnalités et les corrections de bugs avant qu'elles ne soient publiées dans une version stable. Pour aider l'équipe Bun à corriger les bugs plus rapidement, les builds canary téléchargent automatiquement des rapports de plantage vers l'équipe de Bun.

---

Installation d'anciennes versions

Étant donné que Bun est un binaire unique, vous pouvez installer d'anciennes versions en réexécutant le script d'installation avec une version spécifique.

Linux et macOS

Pour installer une version spécifique, passez le tag git au script d'installation :

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

Windows

Sur Windows, passez le numéro de version au script d'installation PowerShell :

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

---

Téléchargements directs

Pour télécharger directement les binaires Bun, visitez la page des versions sur GitHub.

Téléchargements de la dernière version

Binaire Linux x64 standard

Pour les anciens CPU sans AVX2

Binaire Windows standard

Pour les anciens CPU sans AVX2

Apple Silicon (M1/M2/M3)

Mac Intel

Systèmes ARM64 Linux

Binaires Musl

Pour les distributions sans glibc (Alpine Linux, Void Linux) :

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

TIP

Si vous rencontrez une erreur comme bun: /lib/x86_64-linux-gnu/libm.so.6: version GLIBC_2.29 not found, essayez d'utiliser le binaire musl. Le script d'installation de Bun choisit automatiquement le binaire correct pour votre système.

---

Configuration CPU requise

Bun a des exigences CPU spécifiques selon le binaire que vous utilisez :

Builds standard

Binaires x64 ciblent l'architecture CPU Haswell (instructions AVX et AVX2 requises)

Plateforme	Exigence Intel	Exigence AMD
x64	Haswell (Core 4e génération) ou ultérieur	Excavator ou ultérieur

Builds Baseline

Binaires x64-baseline ciblent l'architecture Nehalem pour les anciens CPU

Plateforme	Exigence Intel	Exigence AMD
x64-baseline	Nehalem (Core 1e génération) ou ultérieur	Bulldozer ou ultérieur

WARNING

Les builds baseline sont plus lents que les builds réguliers. Utilisez-les uniquement si vous rencontrez une erreur "Illegal Instruction".

::: note Bun ne prend pas en charge les CPU plus anciens que la cible baseline, qui nécessite l'extension SSE4.2. macOS nécessite la version 13.0 ou ultérieure. :::

Désinstallation

Pour supprimer Bun de votre système :

macOS et Linux

rm -rf ~/.bun

Windows

powershell -c ~\.bun\uninstall.ps1

Gestionnaires de packages

npm uninstall -g bun

brew uninstall bun

scoop uninstall bun