# Documenter fails with ssh error

**URL:** <https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976>\
**Category:** General Usage\
**Tags:** documenter, github\
**Created:** [November 30, 2020, 5:30am UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976 "2020-11-30T05:30:04Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![Joris\_Pinkse](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joris_pinkse/32/216398_2.png) [@Joris\_Pinkse](https://discourse.julialang.org/u/Joris_Pinkse)\
**Post date:** [November 30, 2020, 5:30am UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/1 "2020-11-30T05:30:05Z")

</div>

I’m trying to create my first package (using pkgtemplate) but am running into problems generating the documentation using Documenter. I’ve generated ssh keys using DocumenterTools and have stuck them in the indicated place. But the documentation deployment process spits out the following message. What is going wrong here?

 ![Screenshot from 2020-11-30 00-28-47](https://global.discourse-cdn.com/julialang/original/3X/2/1/2186d264b83b5fcd06c443ca036abdfe3afdb294.png)

Thanks!!!

---

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [November 30, 2020, 10:18am UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/2 "2020-11-30T10:18:01Z")

</div>

Looks like you forgot to given the deploy key write permissions to the repository.

---

<div class="post-metadata">

**Author:** ![lmiq](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/lmiq/32/18314_2.png) [@lmiq](https://discourse.julialang.org/u/lmiq)\
**Post date:** [November 30, 2020, 10:38am UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/3 "2020-11-30T10:38:21Z")

</div>

This may help:

> [@Latest version of docs not published (github actions/TagBot)](https://discourse.julialang.org/t/latest-version-of-docs-not-published-github-actions-tagbot/50634/19):
>
> Great, so this is the easy way: (I am writing this mostly to myself in the future, I thank you again for the help here). 1. Create a file: /home/user/.julia/dev/Project/.github/workflows/TagBot.yml and add the content provided here: [TagBot.yml example](https://github.com/JuliaRegistries/TagBot/blob/master/README.md) 2. Use DocumenterTools to generate the keys, with import DocumenterTools DocumenterTools.genkeys() which will output something like: julia\> DocumenterTools.genkeys() [ Info: add the public key below to https://github.com/$USER/$REPO/settings…

---

<div class="post-metadata">

**Author:** ![Joris\_Pinkse](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joris_pinkse/32/216398_2.png) [@Joris\_Pinkse](https://discourse.julialang.org/u/Joris_Pinkse)\
**Post date:** [November 30, 2020, 2:25pm UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/4 "2020-11-30T14:25:59Z")

</div>

Thank you @fredrikekre and @lmiq . I regenerated and stuck in the ssh keys in the designated places. Now I get this.

Just to be clear, should these ssh keys go into the Bump.jl repository or in the .io one?

What else could I be missing?

 ![Screenshot from 2020-11-30 09-17-31](https://global.discourse-cdn.com/julialang/original/3X/c/4/c486a46fd31b31e90ddb64b48bf12de2b9ecc468.png)

---

<div class="post-metadata">

**Author:** ![lmiq](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/lmiq/32/18314_2.png) [@lmiq](https://discourse.julialang.org/u/lmiq)\
**Post date:** [November 30, 2020, 2:31pm UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/5 "2020-11-30T14:31:36Z")

</div>

I would recommend clearing the keys you added and follow exactly the steps of the post I mentioned above, and that should do the trick.

---

<div class="post-metadata">

**Author:** ![Joris\_Pinkse](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joris_pinkse/32/216398_2.png) [@Joris\_Pinkse](https://discourse.julialang.org/u/Joris_Pinkse)\
**Post date:** [November 30, 2020, 5:05pm UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/6 "2020-11-30T17:05:35Z")

</div>

Thanks @lmiq . I followed steps 1-3 (again) and the same problem arises. As for step 4, there currently are no tags. Could that be the problem? What role do those tags play?

---

<div class="post-metadata">

**Author:** ![christopher-dG](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/christopher-dg/32/7387_2.png) [@christopher-dG](https://discourse.julialang.org/u/christopher-dG)\
**Post date:** [November 30, 2020, 5:41pm UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/7 "2020-11-30T17:41:23Z")

</div>

@dhairyagandhi96 is apparently seeing the same thing on Flux.jl ([example](https://github.com/FluxML/Flux.jl/runs/1474512822?check_suite_focus=true)), and has also cycled the keys without success.

---

<div class="post-metadata">

**Author:** ![Joris\_Pinkse](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joris_pinkse/32/216398_2.png) [@Joris\_Pinkse](https://discourse.julialang.org/u/Joris_Pinkse)\
**Post date:** [November 30, 2020, 5:46pm UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/8 "2020-11-30T17:46:27Z")

</div>

Thanks @christopher-dG. @dhairyagandhi96’s problem occurs at the same stage, but appears to be different. Mine is related to the RSA host key; see [https://github.com/NittanyLion/Bump.jl/runs/1475194275?check\_suite\_focus=true](https://github.com/NittanyLion/Bump.jl/runs/1475194275?check_suite_focus=true) .

---

<div class="post-metadata">

**Author:** ![christopher-dG](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/christopher-dg/32/7387_2.png) [@christopher-dG](https://discourse.julialang.org/u/christopher-dG)\
**Post date:** [November 30, 2020, 5:49pm UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/9 "2020-11-30T17:49:04Z")

</div>

That RSA key thing isn’t actually an issue, [your docs are pushed just fine now](https://github.com/NittanyLion/Bump.jl/tree/gh-pages). GH Pages sometimes takes a long time to deploy the first version of docs, or your repo settings might be incorrect for GH Pages. Either way you no longer have a Documenter.jl problem. 🙂

Edit: You did have the “invalid format” error in your first screenshots, and cycling your keys appears to have fixed that.

---

<div class="post-metadata">

**Author:** ![Joris\_Pinkse](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/joris_pinkse/32/216398_2.png) [@Joris\_Pinkse](https://discourse.julialang.org/u/Joris_Pinkse)\
**Post date:** [November 30, 2020, 7:24pm UTC](https://discourse.julialang.org/t/documenter-fails-with-ssh-error/50976/10 "2020-11-30T19:24:51Z")

</div>

Thanks @christopher-dG! So how do I get it to show up if one clicks on docs/stable at the bottom of the page?