From e6922bfd6f89ff2c7f30dda3ff7695c2a309b939 Mon Sep 17 00:00:00 2001
From: Marcel Jacek <Marcel.Jacek@stackit.cloud>
Date: Wed, 23 Jul 2025 11:09:46 +0200
Subject: [PATCH 1/3] Docs: Add guide to uninstall the deprecated formular and
 reinstall it as cask

---
 INSTALLATION.md | 41 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/INSTALLATION.md b/INSTALLATION.md
index 35bdd5149..e9c5d0c56 100644
--- a/INSTALLATION.md
+++ b/INSTALLATION.md
@@ -17,7 +17,46 @@ brew tap stackitcloud/tap
 2. You can then install the CLI via:
 
 ```shell
-brew install stackit
+brew install --cask stackit
+```
+
+#### Formular deprecated
+
+The homebrew formula is deprecated, will no longer be updated and will be removed after 2026-01-22.
+You need to install it as cask.  
+Therefor you need to uninstall the formular and reinstall it as cask.  
+Your profiles should normally remain. To ensure that nothing will be gone, you should backup them.
+
+1. Export your existing profiles. This will create a json file in your current directory.
+```shell
+stackit config profile export default
+```
+
+2. If you have multiple profiles, then execute the export command for each of them. You can find your profiles via:
+
+```shell
+stackit config profile list
+stackit config profile export <profile-name>
+```
+
+3. Uninstall the formula.
+```shell
+brew uninstall stackit
+```
+
+4. Install the STACKIT CLI as cask.
+```shell
+brew install --cask stackit
+```
+
+5. Check if your configs are still stored.
+```shell
+stackit config profile list
+```
+
+6. If the profiles are gone, import your profiles via:
+```shell
+$ stackit config profile import -c @default.json --name myProfile
 ```
 
 ### Linux

From b10086c6e3cb6ffa948a22345af4c6782a29f57a Mon Sep 17 00:00:00 2001
From: Marcel Jacek <Marcel.Jacek@stackit.cloud>
Date: Fri, 25 Jul 2025 10:19:37 +0200
Subject: [PATCH 2/3] review feedback

---
 INSTALLATION.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/INSTALLATION.md b/INSTALLATION.md
index e9c5d0c56..da55c06ae 100644
--- a/INSTALLATION.md
+++ b/INSTALLATION.md
@@ -20,10 +20,10 @@ brew tap stackitcloud/tap
 brew install --cask stackit
 ```
 
-#### Formular deprecated
+#### Formula deprecated
 
 The homebrew formula is deprecated, will no longer be updated and will be removed after 2026-01-22.
-You need to install it as cask.  
+You need to install the STACKIT CLI as cask.  
 Therefor you need to uninstall the formular and reinstall it as cask.  
 Your profiles should normally remain. To ensure that nothing will be gone, you should backup them.
 
@@ -54,7 +54,7 @@ brew install --cask stackit
 stackit config profile list
 ```
 
-6. If the profiles are gone, import your profiles via:
+6. In case the profiles are gone, import your profiles via:
 ```shell
 $ stackit config profile import -c @default.json --name myProfile
 ```

From 13ac792986167b849aa383efa3939d79cd718488 Mon Sep 17 00:00:00 2001
From: Marcel Jacek <72880145+marceljk@users.noreply.github.com>
Date: Fri, 25 Jul 2025 12:52:59 +0200
Subject: [PATCH 3/3] Update INSTALLATION.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ruben Hönle <Ruben.Hoenle@stackit.cloud>
---
 INSTALLATION.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/INSTALLATION.md b/INSTALLATION.md
index da55c06ae..965ceddf9 100644
--- a/INSTALLATION.md
+++ b/INSTALLATION.md
@@ -24,7 +24,8 @@ brew install --cask stackit
 
 The homebrew formula is deprecated, will no longer be updated and will be removed after 2026-01-22.
 You need to install the STACKIT CLI as cask.  
-Therefor you need to uninstall the formular and reinstall it as cask.  
+Therefor you need to uninstall the formula and reinstall it as cask.  
+
 Your profiles should normally remain. To ensure that nothing will be gone, you should backup them.
 
 1. Export your existing profiles. This will create a json file in your current directory.