Troubleshooting

Debug Mode

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

vgs -d get routes --vault <VAULT_ID>

This will output a stack trace which you can share with VGS Support.

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:

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:

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, consider using VirtualEnv.

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 [email protected].