Skip to content


Repository files navigation

A bare bones example of a Pelican generated static site for a blog that you can easily deploy to a PaaS.


First install Pelican. For example on Ubuntu you can install it via:

# Install pip
$ sudo apt-get install python-pip

# Install pelican via pip
$ sudo pip install pelican

# Install markdown via pip (we're going to write our posts in Markdown)
$ sudo pip install markdown

Then to set the bare site up locally, clone this repository:

# Clone it locally:
$ git clone --recursive my-blog

# Enter the directory:
$ cd my-blog


To run the dev server locally (i.e. while you are writing a post):

# Start it up:
$ ./ start

The dev server will keep running until you stop it. Any edits made to your site will be noticed (it polls the filesystem) and the site will be regenerated. To stop the dev server:

# Stop it
$ ./ stop

To deploy it your Dokku powered PaaS:

# Add a git remote for your Dokku server:
$ git add remote production

# Push it:
$ git push production master


  • Easy to setup
  • Should "just work" out of the box.
  • Includes custom 403, 404, and 500 error pages.
  • Defaults to using a slightly customized Octopress theme. Changing to a different theme is just a matter of picking one and editing There a lot of themes to choose from.
  • Preconfigured for "git style" deploys to Dokku with a slightly customized pelican build pack (mainly adds additional error pages to the nginx config).

Customization Steps

  1. Edit

    1. Change AUTHOR
    2. Change SITE_NAME
    3. Change SITE_SUBTITLE
    4. Change AUTHOR_ABOUT (optional)
    5. Change TIMEZONE (optional)
  2. Edit

    1. Change SITEURL
    2. Set GOOGLE_ANALYTICS (optional)
  3. Edit pages/

  4. Edit pages/

  5. Add your GPG key to extras/publickey.asc (optional)

  6. Edit content/posts/

New Posts

Add new posts written in Markdown by creating new ".md" files in the content/posts directory. You can use the file as an example.


Pelican itself is licensed under the AGPL.

The sample site published in this repo is released under the MIT license. See the file LICENSE.


A bare bones example of a Pelican powered blog that can be deployed to a Dokku powered PaaS







No releases published


No packages published