Help us improve the AWS re:Post Knowledge Center by sharing your feedback in a brief survey. Your input can influence how we create and update our content to better support your AWS journey.
Unable to configure Amazon Q on Mac - DOA?
Downloaded Amazon Q CLI (ver 1.12.2) on macOS 15.5 (24F74).
Tried installing the first time and it gave the error as shown in the image:
Tried deleting the installation, but it kept giving the error:
There was no indication that Q has been started. Finally, figured out that Q was sitting on the menu bar. Clicked on "Getting Started" and it opens a window "Not Found"
What steps am I missing that the install is not happening correctly?
- Newest
- Most votes
- Most comments
I stopped Q, deleted it, installed it again and now it seems to be working:
~% q doctor
✔ Everything looks good!
Amazon Q still not working? Run q issue to let us know!
It looks like you're experiencing several issues with your Amazon Q CLI installation on macOS. Here are some troubleshooting steps to help resolve these problems:
-
First, try running the
q doctorcommand in your terminal. This built-in diagnostic tool can identify and fix common issues with your Amazon Q installation. -
If you're still having problems, check your internet connection as this could affect the installation and authentication process.
-
For the deletion error you encountered, make sure Amazon Q is completely closed (check the menu bar and quit the application) before attempting to uninstall it.
-
For the "Not Found" error when clicking "Getting Started," this could indicate an authentication issue or incomplete installation.
-
Try a complete reinstallation:
- Ensure Amazon Q is fully closed
- Uninstall the current version
- Download a fresh copy and reinstall
-
If you continue to experience issues, you can report the problem using the
q issuecommand in your terminal. -
For help with specific commands, you can use the
--helpflag (e.g.,q --helporq [COMMAND] --help) to see available options and proper usage.
These steps should help resolve the installation issues you're experiencing with Amazon Q CLI on your Mac.
Sources
Installing Amazon Q for command line - Amazon Q Developer
Configuring Amazon Q settings - Amazon Q Developer
I tried the q doctor command and got the following error:
% q doctor
✘ Auth: Not authenticated. Please run q login
error: Not authenticated. Please run q login
% q login
✔ Select login method · Use for Free with Builder ID
error: dispatch failure
Relevant content
- asked 6 months ago
- asked 10 months ago
