diff --git a/README.md b/README.md
index b42a9867..b93c7ef0 100644
--- a/README.md
+++ b/README.md
@@ -691,6 +691,15 @@ GITHUB_TOKEN= gh auth login
 
 `gh` must store the credentials so it can work in a subshell.
 
+**Why am I getting authentication error from gh? Part 2**
+
+It is possible that Octo is trying to authenticate against the origin listed in your repository's config (.git/config) which _could be_ an _ssh alias_ to _github.com_. To properly let octo.nvim know about the ssh alias, you need to list it in the config per above. Example:
+```lua
+require('octo').setup({
+  ssh_aliases = {["<THE ALIAS YOU HAVE LISTED IN ~/.ssh/config>"] = "github.com"}
+})
+```
+
 **Can I use treesitter markdown parser with octo buffers?**
 
 Just add the following lines to your TreeSitter config: