aboutsummaryrefslogtreecommitdiff
path: root/docs/cli/bun-upgrade.md
blob: a9d0759b6a4c8265c550d552b94851b3dda394bf (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
To upgrade Bun, run `bun upgrade`.

It automatically downloads the latest version of Bun and overwrites the currently-running version.

This works by checking the latest version of Bun in [bun-releases-for-updater](https://github.com/Jarred-Sumner/bun-releases-for-updater/releases) and unzipping it using the system-provided `unzip` library (so that Gatekeeper works on macOS)

If for any reason you run into issues, you can also use the curl install script:

```bash
$ curl https://bun.sh/install | bash
```

It will still work when Bun is already installed.

Bun is distributed as a single binary file, so you can also do this manually:

- Download the latest version of Bun for your platform in [bun-releases-for-updater](https://github.com/Jarred-Sumner/bun-releases-for-updater/releases/latest) (`darwin` == macOS)
- Unzip the folder
- Move the `bun` binary to `~/.bun/bin` (or anywhere)

## `--canary`

[Canary](https://github.com/oven-sh/bun/releases/tag/canary) builds are generated on every commit.

To install a [canary](https://github.com/oven-sh/bun/releases/tag/canary) build of Bun, run:

```bash
$ bun upgrade --canary
```

This flag is not persistent (though that might change in the future). If you want to always run the canary build of Bun, set the `BUN_CANARY` environment variable to `1` in your shell's startup script.

This will download the release zip from https://github.com/oven-sh/bun/releases/tag/canary.

To revert to the latest published version of Bun, run:

```bash
$ bun upgrade
```
'logsubject'>WIPGravatar Colin McDonnell 2-24/+106 2023-10-12Improve helptextGravatar Colin McDonnell 1-55/+83 2023-10-12WIPGravatar Colin McDonnell 3-49/+147 2023-10-12WIPGravatar Colin McDonnell 2-0/+19 2023-10-12fix install testGravatar Dylan Conway 2-6/+8 2023-10-12fix editing package json when adding github dependency (#6432)Gravatar Dylan Conway 5-14/+146 * fix package name added to package json * check for github tag * remove alloc * some tests * fix test 2023-10-12Update installation.mdGravatar Colin McDonnell 1-8/+14 2023-10-12Update installation.mdGravatar Colin McDonnell 1-3/+3 2023-10-12fix(install): re-evaluate overrides when removedbun-v1.0.6Gravatar dave caruso 3-3/+45 2023-10-12chore: add missing ending quote (#6436)Gravatar Luna 1-1/+1 2023-10-12feat(install): support npm overrides/yarn resolutions, one level deep only ↵Gravatar dave caruso 7-31/+640 (#6435) * disable zig fmt on generated ResolvedSourceTag.zig * overrides * it works * ok * a --------- Co-authored-by: Jarred Sumner <jarred@jarredsumner.com> 2023-10-11fix #6416 (#6430)Gravatar Dylan Conway 2-1/+132 * make sure latest is checked after prerelease * test and fix * test for when latest matches prerelease 2023-10-11Bump WebKitGravatar Jarred Sumner 9-29/+29 2023-10-11Bump!Gravatar Jarred Sumner 1-1/+1 2023-10-11Update JSCUSocketsLoopIntegration.cppGravatar Dylan Conway 1-2/+2 2023-10-11Update installation.mdGravatar Colin McDonnell 1-10/+7