aboutsummaryrefslogtreecommitdiff
path: root/docs/installation.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/installation.md')
-rw-r--r--docs/installation.md24
1 files changed, 21 insertions, 3 deletions
diff --git a/docs/installation.md b/docs/installation.md
index 576c94e20..a93f915fe 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -1,17 +1,21 @@
Bun ships as a single executable that can be installed a few different ways.
-{% callout %}
-**Windows users** — Bun does not currently provide a native Windows build. We're working on this; progress can be tracked at [this issue](https://github.com/oven-sh/bun/issues/43). In the meantime, use one of the installation methods below for Windows Subsystem for Linux.
+## macOS and Linux
+{% callout %}
**Linux users** — The `unzip` package is required to install Bun. Kernel version 5.6 or higher is strongly recommended, but the minimum is 5.1.
{% /callout %}
{% codetabs %}
-```bash#Native
+```bash#macOS/Linux_(curl)
$ curl -fsSL https://bun.sh/install | bash # for macOS, Linux, and WSL
```
+<!-- ```sh#Windows
+PS> irm https://bun.sh/install | iex
+``` -->
+
```bash#NPM
$ npm install -g bun # the last `npm` command you'll ever need
```
@@ -32,6 +36,20 @@ $ proto install bun
{% /codetabs %}
+## Windows
+
+Bun provides a _limited, experimental_ native build for Windows. At the moment, only the Bun runtime is supported.
+
+- `bun <file>`
+- `bun run <file>`
+
+The test runner, package manager, and bundler are still under development. The following commands have been disabled.
+
+- `bun test`
+- `bun install/add/remove`
+- `bun link/unlink`
+- `bun build`
+
## Upgrading
Once installed, the binary can upgrade itself.