From 1488529228fbdaa6dc70b513537b00b6ec5b0794 Mon Sep 17 00:00:00 2001
From: Laura Hausmann <laura@hausmann.dev>
Date: Tue, 7 Nov 2023 01:53:25 +0100
Subject: [PATCH] [docs] Update bare metal install guide

---
 docs/install.md | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/docs/install.md b/docs/install.md
index 7b5a72c68..6694f0f34 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -1,6 +1,6 @@
 # Installing Iceshrimp
 
-This document will guide you through manual installation of Iceshrimp on dev branch, for main branch, use Firefish's installation guide.
+This document will guide you through manual installation of Iceshrimp. We also provide prebuilt [packages](/iceshrimp/packaging) for various platforms, should you prefer those over a manual install.
 
 ## Dependencies
 
@@ -36,6 +36,8 @@ This document will guide you through manual installation of Iceshrimp on dev bra
 git clone https://iceshrimp.dev/iceshrimp/iceshrimp.git --depth=1
 ```
 
+If you don't want to run the latest development version, pick a version from [here](https://iceshrimp.dev/iceshrimp/iceshrimp/releases) and run `git checkout <version>` before continuing.
+
 ### Creating a new user
 
 In case you want to run Iceshrimp as a different user, run `adduser --disabled-password --disabled-login iceshrimp`  
@@ -126,18 +128,33 @@ If this is your first run, after Iceshrimp has started successfully, you'll be a
 
 ### Updating Iceshrimp
 
-Shut down Iceshrimp and then run these commands
+First, stop the Iceshrimp service and then run the following commands:
 
 ```sh
 ## Run git stash commands only if you have uncommitted changes
 git stash
+```
+
+If you were previously running a tagged release and/or want to upgrade to one, run:
+```sh
+git fetch --tags
+git checkout <new-version>
+```
+
+If you were previously running a development version, and want to continue doing so or switch to the latest commit, run:
+```sh
+git switch dev
 git pull
+```
+
+Regardless of which of the above you picked, run:
+```sh
 git stash pop
 yarn
 yarn build && yarn migrate
 ```
 
-Start Iceshrimp back up
+Now restart the Iceshrimp service and everything should be up to date.
 
 ## Post-install