Using Pelican to deploy static website in Gitlab

Static Website hosting on gitlab

I my last article I wrote about gitlab pages. This article is a quick note on how to deploy your static blog using pelican.

This is a more developer /  computer known person prespective. If something goes wrong do ping me

Steps :

  1. Sign up for an account at
  2. Create a new project called blog.
  3. Open the GNU/Linux terminal and follow the steps.
  4. sudo dnf install python-pip (Fedora) or sudo apt-get install python-pip (Debian)
  5. sudo pip install virtualenv
  6. cd ~/Documents
  7. git clone
  8. virtualenv blog
  9. cd blog
  10. source bin activate
  11. pip install pelican markdown
  12. pelican-quickstart .Once you hit this command,enter the details of your site name and description. Go with the defaults for the rest of the things.
  13. cd content
  14. create a file called (or any name). Write content following this pattern
  15. cd ../
  16. type the command "pelican" . Once this command is done, you should have a folder called output. If that has generated, proceed, else hold up and cross check any errors or missed steps.
  17. create a file called .gitlab-ci.yml and enter the following contents in it. """ pages: stage: deploy script:
  • mkdir .public
  • cp -r output/* .public
  • mv .public public artifacts: paths:
  • public only:
  • master """
  1. git add .
  2. git commit -m "Blog on gitlab"
  3. git push

You are done. If all go good, you should see the build starting in your projects build page.

Now sit back and relax until the build completes. Once done, you should see your website live at

If you are looking for a ready repo, have a look at the sample repo I have put up

I also have a sample blog running here

If you have written it better, send me a PR :-)

All wrongs reserved !! Content unless notified is under Creative Commons by SA 4.0