Preview Server

Preview your site without deploy

catsup server
catsup server -p 8000

Preview server will regenerate your site when :

  • Your source folder (posts by default) changes (Like add a new post or modify one)
  • Your theme folder changes(Useful for writing themes for Catsup)
  • Catsup program changes(Useful for writing codes for Catsup)


Catsup will ignore site.url and build your site into a temporary directory when running Preview Server.

Deploy Support

Help you deploy your site via git or rsync

catsup deploy # Deploy via default way
catsup rsync # Deploy via rsync
catsup git # Deploy via git


If you host your site’s source on GitHub or Bitbucket, Catsup can generate your site when you push to your repo.

You need to clone your repo and start webhook server

git clone git://path/to/your/site.git
cd site
catsup webhook -p 12580


Catsup webhook is not a daemon process.That means you may need to use Supervisor to turn it into daemon.

Then configure webhook on GitHub or Bitbucket. Here we use GitHub as an example:

  • Go to the “admin” page for your project
  • Click “Service Hooks”
  • In the available service hooks, click “WebHook URLs“
  • Type your url [1]
  • Click “Update Settings”
[1]If your server’s ip is , you can type

Then when you push to GitHub, Catsup will pull and generate your site.