Update installation instructions and troubleshooting guide for clarity and fallback options

Author: itzCozi

README.md

@@ -33,12 +33,19 @@ devbox focuses on fast, disposable, Docker-native development environments with
 ## Installation
 
 ```bash
-# Using the install script
+# Using the install script (primary)
+curl -fsSL https://raw.githubusercontent.com/itzcozi/devbox/main/install.sh | bash
+
+# Mirror (CDN)
 curl -fsSL https://devbox.ar0.eu/install.sh | bash
 # Or manually: https://devbox.ar0.eu/docs/install/#manual-build-from-source
 ```
 
-Note: devbox supports Linux environments only (Debian/Ubuntu). On Windows, use WSL2 with an Ubuntu distribution.
+Notes:
+- Some managed shell environments (e.g., AWS CloudShell) may block or challenge CDN traffic, resulting in HTTP 403 when hitting the mirror. Use the primary GitHub Raw URL above in those environments.
+- devbox supports Linux environments only (Debian/Ubuntu). On Windows, use WSL2 with an Ubuntu distribution.
+
+
 
 ## Quick Start
 

docs/functions/install.sh.js

@@ -31,8 +31,10 @@ export async function onRequest(context) {
       return new Response(upstream.body, { status: 200, headers: respHeaders });
     }
 
-    return new Response('Failed to fetch install script', { status: 502 });
+    // Fallback: redirect client to fetch directly from GitHub raw if proxying fails
+    return Response.redirect(upstreamUrl, 302);
   } catch (err) {
-    return new Response('Failed to fetch install script', { status: 502 });
+    // Network error fetching from upstream; try redirecting the client
+    return Response.redirect(upstreamUrl, 302);
   }
 }

docs/src/content/docs/docs/install.md

@@ -4,9 +4,15 @@ description: How to install devbox on your Debian/Ubuntu system
 ---
 
 ```bash
+# Primary (recommended)
+curl -fsSL https://raw.githubusercontent.com/itzcozi/devbox/main/install.sh | bash
+
+# Mirror (CDN)
 curl -fsSL https://devbox.ar0.eu/install.sh | bash
 ```
 
+If you encounter a 403 when using the mirror (common in some managed shells like AWS CloudShell), use the primary GitHub Raw URL instead.
+
 This script will automatically:
 - Check system compatibility (Debian/Ubuntu only)
 - Install Go, Docker, make, and git if needed

docs/src/content/docs/docs/troubleshooting.md

@@ -8,6 +8,44 @@ Common issues and quick fixes.
 ## Installation Issues
 ---
 
+##### "403 Forbidden" when running install script
+
+**Problem**: Running `curl -fsSL https://devbox.ar0.eu/install.sh | bash` returns 403 (often in managed shells like AWS CloudShell).
+
+**Explanation**: Some environments block or challenge CDN traffic. Our mirror uses a CDN and may be affected. We've added a server-side fallback to redirect to GitHub Raw, but certain environments still enforce restrictions.
+
+**Solutions**:
+```bash
+# Use the primary GitHub Raw URL
+curl -fsSL https://raw.githubusercontent.com/itzcozi/devbox/main/install.sh | bash
+
+# Or download and run locally
+curl -fsSL -o install.sh https://raw.githubusercontent.com/itzcozi/devbox/main/install.sh
+bash install.sh
+```
+
+##### Amazon Linux 2023
+
+**Problem**: The install script reports an unsupported OS on Amazon Linux 2023.
+
+**Explanation**: devbox officially supports Debian/Ubuntu. Amazon Linux 2023 (AL2023) is Fedora-like and uses `dnf` instead of `apt`.
+
+**Workaround (manual)**:
+```bash
+# Install deps (rough equivalent)
+sudo dnf install -y git make golang docker
+sudo systemctl enable --now docker
+sudo usermod -aG docker $USER
+
+# Build and install devbox
+git clone https://github.com/itzcozi/devbox.git
+cd devbox
+make build
+sudo make install
+```
+
+> Note: We may add broader distro support in the future; contributions welcome.
+
 ##### "Command not found: devbox"
 
 **Problem**: After installation, `devbox` command is not recognized.