Repo to illustrate the "Install and deploy a Pelican blog using Fabric" series
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

#Pelican blog tutorial

Repository to illustrate the Install and deploy a Pelican blog using Fabric series.

Its aim is to quickly get a Pelican blog running locally and to provide an easy way to test the provisionning of a server and the publication of content with Fabric.

##Get it running

Clone the project:

git clone

Change the origin for your own repository and push:

git remote set-url origin
git push -u origin --all

Open "" and assign your repository to the "git_repository" variable.

Download VirtualBox at ("platform packages") and install it.
Download Vagrant at and install it.

The Vagrantfile is set up to use the Multi-Machine feature. It manages two virtual machines: one that will be the "local" one, and another that is going to be used to simulate a remote server.

From the project root, run:

vagrant up local

This will start and provision a VM with everything required to run Pelican locally.

From a new terminal, start the "server" machine:

vagrant up server

ssh the "local" machine (vagrant ssh local) and run:

cd /vagrant
fab provision
fab publish

fab provision will ssh the "server" machine to install the required packages and set up nginx so that the blog will be accessible at

fab publish will pull the files from your Git repository, install the blog's dependencies and generate the HTML content.

The first time you run it, it will create a ssh key pair for you and ask you to add the private key to your repository. Do so and hit return to continue the process.

Add this line to your host machine's "hosts" file:

Save and visit

Please see the complete tutorial for a full explanation.