# Franklin deployment problems

**URL:** <https://discourse.julialang.org/t/franklin-deployment-problems/37519>\
**Category:** Web Stack\
**Tags:** question\
**Created:** [April 13, 2020, 5:29pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519 "2020-04-13T17:29:05Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![KajWiik](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kajwiik/32/199_2.png) [@KajWiik](https://discourse.julialang.org/u/KajWiik)\
**Post date:** [April 13, 2020, 5:29pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/1 "2020-04-13T17:29:05Z")

</div>

I have a locally working Franklin website and have difficulties in deploying it to github. I have tried both with the current documentation and [https://github.com/tlienart/Franklin.jl/issues/390](https://github.com/tlienart/Franklin.jl/issues/390)

The problem seems to be that deployment doesn’t get triggered, deploy key stays ‘Never used’ and github pages source does not show gh-pages branch.

Yes, I have triple checked the keys, both with deploy key names FRANKLIN\_PUB and DEPLOY\_KEY.

Which of the deployment setups is currently working?

Julia Version 1.4.0, Franklin v0.6.17

---

<div class="post-metadata">

**Author:** ![tlienart](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tlienart/32/7640_2.png) [@tlienart](https://discourse.julialang.org/u/tlienart)\
**Post date:** [April 13, 2020, 5:47pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/2 "2020-04-13T17:47:13Z")

</div>

Hello!

Sorry about that, did you follow the _recently updated_ instructions [here](https://franklinjl.org/workflow/deploy/#deploying_on_github)? if you’re using `DEPLOY_KEY` as a name it would seem that that’s maybe not the case.

Also could you link to your repo so that I can have a look at the workflow? do you use [this one](https://github.com/tlienart2/myWebsite/blob/master/.github/workflows/deploy.yml) ?

Here is also a working project repo you could copy that gathers the instruction: [https://github.com/tlienart2/myWebsite](https://github.com/tlienart2/myWebsite)

Random other things I can think of:

- does your deploy key have write access?
- did you follow the proper instructions for either a project/user website depending on your case?

---

<div class="post-metadata">

**Author:** ![KajWiik](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kajwiik/32/199_2.png) [@KajWiik](https://discourse.julialang.org/u/KajWiik)\
**Post date:** [April 13, 2020, 7:59pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/3 "2020-04-13T19:59:45Z")

</div>

Many thanks for your quick and friendly reply!

> [@tlienart](#):
>
> Sorry about that, did you follow the _recently updated_ instructions [here](https://franklinjl.org/workflow/deploy/#deploying_on_github)? if you’re using `DEPLOY_KEY` as a name it would seem that that’s maybe not the case.

I deleted my previous tests and started from scratch and followed the new instructions: I used `FRANKLIN_PRIV` and `FRANKLIN_PUB`as the names of the ḱeys.

> [@tlienart](#):
>
> Also could you link to your repo so that I can have a look at the workflow? do you use [this one](https://github.com/tlienart2/myWebsite/blob/master/.github/workflows/deploy.yml) ?

Here’s the repo: [https://github.com/KajWiik/myWebsite](https://github.com/KajWiik/myWebsite)  
I used the workflow that was automatically generated (by `serve()`?). I can test that one also (not in the instructions).

> [@tlienart](#):
>
> - does your deploy key have write access?
> - did you follow the proper instructions for either a project/user website depending on your case?

Yes and yes.

---

<div class="post-metadata">

**Author:** ![tlienart](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tlienart/32/7640_2.png) [@tlienart](https://discourse.julialang.org/u/tlienart)\
**Post date:** [April 13, 2020, 8:06pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/4 "2020-04-13T20:06:59Z")

</div>

Cool ok, note that it works: [https://github.com/KajWiik/myWebsite/tree/gh-pages](https://github.com/KajWiik/myWebsite/tree/gh-pages)

Can you check in the repo settings that `gh-pages` is picked up as the page?

---

<div class="post-metadata">

**Author:** ![KajWiik](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kajwiik/32/199_2.png) [@KajWiik](https://discourse.julialang.org/u/KajWiik)\
**Post date:** [April 13, 2020, 8:08pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/5 "2020-04-13T20:08:35Z")

</div>

A little progress, with [this workflow](https://github.com/tlienart2/myWebsite/blob/master/.github/workflows/deploy.yml) the deployment was triggered. Now the problem is that the site seems to be very barebones without CSS. [https://kajwiik.github.io/myWebsite/](https://kajwiik.github.io/myWebsite/)

---

<div class="post-metadata">

**Author:** ![tlienart](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tlienart/32/7640_2.png) [@tlienart](https://discourse.julialang.org/u/tlienart)\
**Post date:** [April 13, 2020, 8:15pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/6 "2020-04-13T20:15:31Z")

</div>

could you try merging the two PR I made to your repo (specifically the one with config, the other one is irrelevant) and see if that helps? the issue is a common one when `prepath` is not set properly (in your case it was though so I just tried to simplify the file)

---

<div class="post-metadata">

**Author:** ![KajWiik](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kajwiik/32/199_2.png) [@KajWiik](https://discourse.julialang.org/u/KajWiik)\
**Post date:** [April 13, 2020, 8:23pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/7 "2020-04-13T20:23:54Z")

</div>

Done. No change, strange…

---

<div class="post-metadata">

**Author:** ![tlienart](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tlienart/32/7640_2.png) [@tlienart](https://discourse.julialang.org/u/tlienart)\
**Post date:** [April 13, 2020, 8:33pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/8 "2020-04-13T20:33:36Z")

</div>

now it should work [https://kajwiik.github.io/myWebsite/](https://kajwiik.github.io/myWebsite/) 👍

---

<div class="post-metadata">

**Author:** ![KajWiik](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kajwiik/32/199_2.png) [@KajWiik](https://discourse.julialang.org/u/KajWiik)\
**Post date:** [April 13, 2020, 8:39pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/9 "2020-04-13T20:39:26Z")

</div>

In julia REPL I tried:

```julia
julia> verify_links()
All internal links verified ✓. nline ✗]

julia> publish()
┌ Warning: I couldn't load 'highlight.js' so will not be able to pre-render code blocks. You can install it with `npm install highlight.js`.
└ @ Franklin ~/.julia/packages/Franklin/ptv2u/src/manager/post_processing.jl:169
→ Full pass (with pre-rendering) [done 9.2s]                                                                                                                                                                                    
→ Minifying *.[html|css] files... [done 566.8ms]                                                                                                                                                                                    
→ Pushing updates with git... fatal: The current branch master has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin master

✘ Could not push updates, verify your connection and/or try manually.

e = ProcessFailedException(Base.Process[Process(`git push --quiet`, ProcessExited(128))])

```

After `git push --set-upstream origin master`:

```julia
julia> publish()
┌ Warning: I couldn't load 'highlight.js' so will not be able to pre-render code blocks. You can install it with `npm install highlight.js`.
└ @ Franklin ~/.julia/packages/Franklin/ptv2u/src/manager/post_processing.jl:169
→ Full pass (with pre-rendering) [done 126.6ms]                                                                                                                                                                                   
→ Minifying *.[html|css] files... [done 498.0ms]                                                                                                                                                                                    
→ Pushing updates with git... [done 4.1s]                                                                                                                                                                                     

```

And now it seems to almost work, some problems with tables…

```julia
$ npm install highlight.js
/home/kjwiik/proj/myWebsite
└── highlight.js@9.18.1 

npm WARN enoent ENOENT: no such file or directory, open '/home/kjwiik/proj/myWebsite/package.json'
npm WARN myWebsite No description
npm WARN myWebsite No repository field.
npm WARN myWebsite No README data
npm WARN myWebsite No license field.

```

Still `publish()` does not find highlight.js, strange…

But most of the stuff seems to work, many thanks @tlienart!

---

<div class="post-metadata">

**Author:** ![tlienart](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tlienart/32/7640_2.png) [@tlienart](https://discourse.julialang.org/u/tlienart)\
**Post date:** [April 13, 2020, 8:42pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/10 "2020-04-13T20:42:51Z")

</div>

Yes, please use NodeJS.jl to install highlight and get Julia to find it without issue, see [the docs here](https://franklinjl.org/#installing_optional_extras)

**Note** : given you use the github action, you do not need to use `publish`, just push your changes and github action does the rest (including highlight etc).

(I should clarify this in the docs, PRs welcome 🙂 )

---

<div class="post-metadata">

**Author:** ![KajWiik](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kajwiik/32/199_2.png) [@KajWiik](https://discourse.julialang.org/u/KajWiik)\
**Post date:** [April 13, 2020, 8:51pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/11 "2020-04-13T20:51:01Z")

</div>

> [@tlienart](#):
>
> Yes, please use NodeJS.jl to install highlight and get Julia to find it without issue, see [the docs here](https://franklinjl.org/#installing_optional_extras)

```julia
julia> using NodeJS

julia> run(`sudo $(npm_cmd()) install highlight.js`)
[sudo] password for kjwiik: 
npm WARN saveError ENOENT: no such file or directory, open '/home/kjwiik/proj/myWebsite/package.json'
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN enoent ENOENT: no such file or directory, open '/home/kjwiik/proj/myWebsite/package.json'
npm WARN myWebsite No description
npm WARN myWebsite No repository field.
npm WARN myWebsite No README data
npm WARN myWebsite No license field.

+ highlight.js@9.18.1
updated 1 package and audited 1 package in 1.1s
found 0 vulnerabilities

Process(`sudo /home/kjwiik/.julia/artifacts/a42f5c72a500a8683c08a5e818d27a104fc9cd5a/bin/node /home/kjwiik/.julia/artifacts/a42f5c72a500a8683c08a5e818d27a104fc9cd5a/bin/npm install highlight.js`, ProcessExited(0))

julia> publish()
┌ Warning: I couldn't load 'highlight.js' so will not be able to pre-render code blocks. You can install it with `npm install highlight.js`.
└ @ Franklin ~/.julia/packages/Franklin/ptv2u/src/manager/post_processing.jl:169
→ Full pass (with pre-rendering) [done 178.4ms]                                                                                                                                                                                   
→ Minifying *.[html|css] files... [done 492.9ms]                                                                                                                                                                                    
→ Pushing updates with git... [done 4.4s]                                                                                                                                                                                     

```

> [@tlienart](#):
>
> **Note** : given you use the github action, you do not need to use `publish` , just push your changes and github action does the rest (including highlight etc).

To me, it seemed that `publish()` solved the missing CSS problem, of course it could be just timing…

> [@tlienart](#):
>
> (I should clarify this in the docs, PRs welcome 🙂 )

I try to remember to make PR after this has cleared up 🙂

---

<div class="post-metadata">

**Author:** ![KajWiik](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kajwiik/32/199_2.png) [@KajWiik](https://discourse.julialang.org/u/KajWiik)\
**Post date:** [April 13, 2020, 9:49pm UTC](https://discourse.julialang.org/t/franklin-deployment-problems/37519/12 "2020-04-13T21:49:41Z")

</div>

> [@KajWiik](#):
>
> And now it seems to almost work, some problems with tables…

It seems that the table problem is caused by the `vela` template, in `lanyon` tables work ok.