diff --git a/doc/install.md b/doc/install.md
index bd2dd5a0..46cecc10 100644
--- a/doc/install.md
+++ b/doc/install.md
@@ -1,12 +1,15 @@
-# Installing Dagger
+# Installing or upgrading Dagger
 
 ## Summary
- - [Option 1 (Mac OS only): install from Homebrew](#option-1--mac-os-only---install-from-homebrew)
- - [Option 2: install from a shell script](#option-2--install-from-a-shell-script)
- - [Option 3: Manually fetch the latest binary release from Github](#option-3--manually-fetch-the-latest-binary-release-from-github)
- - [Option 4: Compile from source](#option-4--compile-from-source)
 
-## Option 1 (Mac OS only): install from Homebrew
+- [Installing or upgrading Dagger](#installing-or-upgrading-dagger)
+  - [Summary](#summary)
+  - [Option 1 (Mac OS only): install or upgrade from Homebrew](#option-1-mac-os-only-install-or-upgrade-from-homebrew)
+  - [Option 2: install or upgrade from a shell script](#option-2-install-or-upgrade-from-a-shell-script)
+  - [Option 3: Manually fetch the latest binary release from Github](#option-3-manually-fetch-the-latest-binary-release-from-github)
+  - [Option 4: Compile from source](#option-4-compile-from-source)
+
+## Option 1 (Mac OS only): install or upgrade from Homebrew
 
 From your Mac OS terminal, run the following command:
 
@@ -14,9 +17,15 @@ From your Mac OS terminal, run the following command:
 brew install dagger/tap/dagger
 ```
 
+If dagger is already installed, you can upgrade it using this command:
+
+```shell
+brew update; brew upgrade dagger
+```
+
 > :bulb: Verify the installation with `dagger version`.
 
-## Option 2: install from a shell script
+## Option 2: install or upgrade from a shell script
 
 From a terminal, run the following command:
 
@@ -64,4 +73,4 @@ cd dagger; make
 cp ./cmd/dagger/dagger /usr/local/bin
 ```
 
-> :bulb: Verify the installation with `dagger version`.
\ No newline at end of file
+> :bulb: Verify the installation with `dagger version`.
diff --git a/doc/update.md b/doc/update.md
deleted file mode 100644
index 0b0c4cea..00000000
--- a/doc/update.md
+++ /dev/null
@@ -1,67 +0,0 @@
-# Updating Dagger
-
-## Summary
- - [Option 1: (Mac OS only): update from Homebrew](#option-1--mac-os-only---update-from-homebrew)
- - [Option 2: update from a shell script](#option-2--update-from-a-shell-script)
- - [Option 3: Manually fetch the latest binary release from Github](#option-3--manually-fetch-the-latest-binary-release-from-github)
- - [Option 4: Compile from source](#option-4--compile-from-source)
-
-## Option 1: (Mac OS only): update from Homebrew
-
-From your Mac OS terminal, run the following command:
-
-```shell
-brew update dagger/tap/dagger
-```
-
-> :bulb: Verify the update with `dagger version`.
-
-## Option 2: update from a shell script
-
-From a terminal, run the following command:
-
-```shell
-curl -sfL https://releases.dagger.io/dagger/install.sh | sh
-```
-
-You now have the dagger binary in the local directory under `./bin/dagger`.
-
-You can then update it globally on your system:
-
-```shell
-sudo mv ./bin/dagger /usr/local/bin
-```
-
-> :bulb: Verify the update with `dagger version`.
-
-## Option 3: Manually fetch the latest binary release from Github
-
-Open your web browser to [the latest release](https://github.com/dagger/dagger/releases/latest).
-
-From the **assets** section, download the archive corresponding to your OS and Arch.
-
-> :bulb: Verify the update with `dagger version`.
-
-## Option 4: Compile from source
-
-You will need [Go](https://golang.org) version 1.16 or later.
-
-1. Clone the dagger repository
-
-```shell
-git clone https://github.com/dagger/dagger.git
-```
-
-2. Build the `dagger` binary.
-
-```shell
-cd dagger; make
-```
-
-3. Copy the `dagger` tool to a location listed in your `$PATH`. For example, to copy it to `/usr/local/bin`:
-
-```shell
-cp ./cmd/dagger/dagger /usr/local/bin
-```
-
-> :bulb: Verify the update with `dagger version`.
\ No newline at end of file