diff --git a/docs/docs/guides/installation/compose.mdx b/docs/docs/guides/installation/compose.mdx
index c2e1792896..956f5aa833 100644
--- a/docs/docs/guides/installation/compose.mdx
+++ b/docs/docs/guides/installation/compose.mdx
@@ -1,7 +1,11 @@
-```bash
-# Download the docker compose example configuration
-wget https://raw.githubusercontent.com/zitadel/zitadel/v2-alpha/deploy/compose/docker-compose.yml
+Download the docker compose example configuration
 
-# Run the database and application containers
+```bash
+wget https://raw.githubusercontent.com/zitadel/zitadel/v2-alpha/deploy/compose/docker-compose.yml
+```
+
+Run the database and application containers
+
+```bash
 docker compose up
 ```
diff --git a/docs/docs/guides/installation/linux.mdx b/docs/docs/guides/installation/linux.mdx
index 9c00dcd424..583aed61ab 100644
--- a/docs/docs/guides/installation/linux.mdx
+++ b/docs/docs/guides/installation/linux.mdx
@@ -5,19 +5,28 @@ ZITADEL is tested against CockroachDB v21.2.8.
 
 ## Run CockroachDB and ZITADEL
 
-```bash
-# Run a CockroachDB instance
-cockroach start-single-node --insecure --background --http-addr :9090
+Run a CockroachDB instance
 
-# Configure your environment
-# Generate a master encryption key
+```bash
+cockroach start-single-node --insecure --background --http-addr :9090
+```
+
+Configure your environment and generate a master encryption key
+
+```bash
 export ZITADEL_EXTERNALSECURE=false
 export ZITADEL_EXTERNALDOMAIN=localhost
 export ZITADEL_DEFAULTINSTANCE_CUSTOMDOMAIN=localhost
+```
 
-# Download the zitadel binary
-curl -s https://api.github.com/repos/zitadel/zitadel/releases/tags/v2.0.0-v2-alpha.3 | grep "browser_download_url.*zitadel_.*_linux_$(dpkg --print-architecture)" | cut -d '"' -f 4 | sudo wget -i - -O /usr/local/bin/zitadel && sudo chmod +x /usr/local/bin/zitadel && sudo chown $(id -u):$(id -g) /usr/local/bin/zitadel
+Download the zitadel binary
 
-# Run the database and application containers
+```bash
+curl -s https://api.github.com/repos/zitadel/zitadel/releases/tags/v2.0.0-v2-alpha.6 | grep "browser_download_url.*zitadel_.*_linux_$(dpkg --print-architecture)" | cut -d '"' -f 4 | sudo wget -i - -O /usr/local/bin/zitadel && sudo chmod +x /usr/local/bin/zitadel && sudo chown $(id -u):$(id -g) /usr/local/bin/zitadel
+```
+
+Run the database and application containers
+
+```bash
 zitadel admin start-from-init --masterkey "MasterkeyNeedsToHave32Characters"
 ```
diff --git a/docs/docs/guides/installation/macos.mdx b/docs/docs/guides/installation/macos.mdx
index b21f736c6a..d6cc1a6911 100644
--- a/docs/docs/guides/installation/macos.mdx
+++ b/docs/docs/guides/installation/macos.mdx
@@ -5,16 +5,20 @@ ZITADEL is tested against CockroachDB v21.2.8.
 
 ## Run CockroachDB and ZITADEL
 
-```bash
-# Run a CockroachDB instance
-cockroach start-single-node --insecure --background --http-addr :9090
+Run a CockroachDB instance
 
-# Configure your environment
-# Generate a master encryption key
+```bash
+cockroach start-single-node --insecure --background --http-addr :9090
+```
+
+Configure your environment and generate a master encryption key
+
+```bash
 export ZITADEL_EXTERNALSECURE=false
 export ZITADEL_EXTERNALDOMAIN=localhost
 export ZITADEL_DEFAULTINSTANCE_CUSTOMDOMAIN=localhost
-export MY_ARCHITECTURE="arm64"
+export MY_ARCHITECTURE="arm64 or amd64 depeding on your mac"
+```
 
 # Download and Install ZITADEL
 
@@ -27,9 +31,11 @@ brew install zitadel/tap/zitadel
 ... or download the binary from GitHub
 
 ```bash
-curl -s https://api.github.com/repos/zitadel/zitadel/releases/tags/v2.0.0-v2-alpha.3 | grep "browser_download_url.*zitadel_.*_darwin_${MY_ARCHITECTURE}" | cut -d '"' -f 4 | sudo wget -i - -O /usr/local/bin/zitadel && sudo chmod +x /usr/local/bin/zitadel && sudo chown $(id -u):$(id -g) /usr/local/bin/zitadel
+curl -s https://api.github.com/repos/zitadel/zitadel/releases/tags/v2.0.0-v2-alpha.6 | grep "browser_download_url.*zitadel_.*_darwin_${MY_ARCHITECTURE}" | cut -d '"' -f 4 | sudo wget -i - -O /usr/local/bin/zitadel && sudo chmod +x /usr/local/bin/zitadel && sudo chown $(id -u):$(id -g) /usr/local/bin/zitadel
 ```
 
-# Run the database and application containers
+Run ZITADEL
+
+```bash
 zitadel admin start-from-init --masterkey "MasterkeyNeedsToHave32Characters"
 ```