Step-by-Step Installation of Amazon Q CLI on Ubuntu WSL

✅ Step 1: Install WSL and Ubuntu

If you haven't already installed Ubuntu via WSL, run this in Windows PowerShell as an administrator:

Restart your computer afterwards to complete the installation.

wsl --install -d Ubuntu

✅ Step 2: Update Ubuntu

Open Ubuntu from the Start menu and update your packages:

sudo apt update && sudo apt upgrade -y

✅ Step 3: Install Required Dependencies

Amazon Q CLI depends on libfuse2. Install it:

sudo apt install -y libfuse2 curl

---

✅ Step 4: Download Amazon Q CLI (.deb Package)

Run this command to download the latest Amazon Q CLI Debian package:

curl --proto '=https' --tlsv1.2 -sSf https://desktop-release.q.us-east-1.amazonaws.com/latest/amazon-q.deb -o amazon-q.deb

---

✅ Step 5: Install the .deb package

sudo apt install -y ./amazon-q.deb

✅ Step 6: Launch Amazon Q CLI

Simply run:

q login

This will open Amazon Q CLI, and you’ll be prompted to authenticate.

---

✅ Step 7: Authentication

Choose your authentication method:

• Use for Free: Sign in with your AWS Builder ID. (I have selected AWS Builder ID as option)

• Use with Pro License: Sign in with AWS IAM Identity Center credentials.

Click on the URL

Click on the Confirm and Continue Button

Click on Allow Access Button

You will see Device Authorised Message, and then type only “q”

With Amazon Q successfully configured, you’re now equipped with an intelligent coding companion that responds to your prompts in real time. Whether you're building a simple or tackling more complex logic, Amazon Q can help streamline your development process by generating code snippets, offering explanations, and accelerating problem-solving. Dive in, experiment, and let your creativity lead the way—your next big idea might be just one prompt away.