Quay

Common issues

Git not found

Quay requires the Xcode Command Line Tools. For one-time installation, open Terminal and run:

xcode-select --install

Authentication failed

Your GitHub connection may have expired or been revoked. Quay will show a banner prompting you to sign in again. You can also go to Settings > Change GitHub Connection to reconnect at any time.

If you use a personal access token, make sure it has the repo scope (classic) or Contents: Read and write permission (fine-grained).

Local and remote have diverged

This happens when changes were made both locally and on GitHub. You can:

• Open the folder in Finder to back up your files
• Use "Reset to GitHub Version" to match the remote
• Resolve the conflict manually in a git client

File is too large

GitHub rejects files over 50 MB. Remove the file or add it to .gitignore.

Unignored secrets found

Quay detected files that look like secrets (.env, .pem, .key, etc.). Add them to .gitignore before syncing.

Reset Quay

To start fresh, use Settings > Reset Quay in the app. This removes all repositories, your credentials, and sync history.

Alternatively, from Terminal:

rm -rf ~/Library/Containers/Quay/

Contact

For bug reports and feature requests, send an email.