# Troubleshooting

## Debug Mode

If you're getting errors, you can turn on debug information with `-d`/`--debug` flag:

```bash
vgs -d get routes --vault <VAULT_ID>
```

This will output a stack trace which you can share with [VGS Support](mailto:support@verygoodsecurity.com).

## Known Issues

These are some known issues if you're using Python distribution:

### Code Signing

During login, you can receive similar errors: `Authentication error occurred. Can't store password on keychain`.

This is solved by signing your Python binary with the command:

```bash
codesign -f -s - $(which python)
```

If you're using Python version 3.7 or above you may need to specify full path of your installation. On Mac OS it look like:

```bash
codesign -f -s - /Library/Frameworks/Python.framework/Versions/3.8/Resources/Python.app/Contents/MacOS/Python
```

### Requirements Conflicts

If you're receiving requirements conflicts during installation with [PyPI](https://pypi.org/project/vgs-cli/), consider using [VirtualEnv](https://virtualenv.pypa.io/en/latest/).

### MacOS Keychain Access

* On MacOS, you can see a prompt that will ask for Keychain access. Make sure to always allow VGS CLI to store keys.
* On MacOS, if you accidentally denied Keychain access and there is no more prompts you should open Keychain Access app, then Lock and Unlock login (`File -> Lock/Unlock Keychain "login"`). After that you can try to login with again.

### MacOS Updates

After updates of MacOS you can receive an error `keyring.backends._OS_X_API.Error: (-25293, "Can't fetch password from system")`. Make sure to update your local Python version to the latest and re-install VGS CLI if needed.

## Support

If you're experiencing any other issues, please contact us at <support@vgs.io>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verygoodsecurity.com/vault/developer-tools/vgs-cli/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.