Skip to content

Commit f80c19c

Browse files
committed
Docs: Add guide to uninstall the deprecated formular and reinstall it as cask
1 parent a1859d6 commit f80c19c

File tree

1 file changed

+40
-1
lines changed

1 file changed

+40
-1
lines changed

INSTALLATION.md

Lines changed: 40 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,46 @@ brew tap stackitcloud/tap
1717
2. You can then install the CLI via:
1818

1919
```shell
20-
brew install stackit
20+
brew install --cask stackit
21+
```
22+
23+
#### Formular deprecated
24+
25+
The homebrew formula is deprecated, will no longer be updated and will be removed after 2026-01-22.
26+
You need to install it as cask.
27+
Therefor you need to uninstall the formular and reinstall it as cask.
28+
Your profiles should normally remain. To ensure that nothing will be gone, you should backup them.
29+
30+
1. Export your existing profiles. This will create a json file in your current directory.
31+
```shell
32+
stackit config profile export default
33+
```
34+
35+
2. If you have multiple profiles, then execute the export command for each of them. You can find your profiles via:
36+
37+
```shell
38+
stackit config profile list
39+
stackit config profile export <profile-name>
40+
```
41+
42+
3. Uninstall the formula.
43+
```shell
44+
brew uninstall stackit
45+
```
46+
47+
4. Install the STACKIT CLI as cask.
48+
```shell
49+
brew install --cask stackit
50+
```
51+
52+
5. Check if your configs are still stored.
53+
```shell
54+
stackit config profile list
55+
```
56+
57+
6. If the profiles are gone, import your profiles via:
58+
```shell
59+
$ stackit config profile import -c @default.json --name myProfile
2160
```
2261

2362
### Linux

0 commit comments

Comments
 (0)