From 1278f8201272685d1110f3b41bd45989954d1214 Mon Sep 17 00:00:00 2001 From: Katrina Prosise Date: Thu, 18 Jul 2024 05:03:38 -0400 Subject: [PATCH] Add admonition for credential helper on macOS Used the `important` admonition with how to locate the line to comment out to get the credential helper to work on macOS. Left out other troubleshooting steps, which can be added if warranted. QA steps: checked rendered output in browser, ran linter. No related tasks, quick fix. Signed-off-by: Katrina Prosise --- .../configure-docker-helper.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/source/user-guide/containers-and-docker/configure-docker-helper.rst b/source/user-guide/containers-and-docker/configure-docker-helper.rst index d2ebcbfc0..3f44c7893 100644 --- a/source/user-guide/containers-and-docker/configure-docker-helper.rst +++ b/source/user-guide/containers-and-docker/configure-docker-helper.rst @@ -9,6 +9,20 @@ This enables the use of Docker commands from a personal computer, such as a lapt .. note:: The :ref:`credentials` will need the “containers:read” scope to work with Docker. +.. important:: + On macOS, you may encounter authentication issues. + This is due to Git on OSX using the Keychain Access Utility. + Git attempts to use this for authentication before ``git-credential-fio``. + + The solution is to remove Keychain Access entries from your git config file. + Locate the git config by running:: + + git config -l --show-origin | grep credential + + Edit the gitconfig file with ``credential.helper=osxkeychain``, commenting out the line. + + Fioctl should now be able to authenticate. + To do this, run: .. code:: bash