You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1.5 KiB


Auto-deploy static websites from git repositories

Build dependency status codecov


SSHing into a server and performing a git pull is boring. I couldn't find any free(as in freedom) software for automating static website deploys like GitHub Pages or Netlify.

This is very minimal, all it does is a git fetch $branch but it works for me :)


  1. All configuration is done through ./config/default.toml(can be moved to /etc/static-pages/config.toml). Too add a website, make a similar entry:

    pages = [
    	{ branch = "gh-pages", repo = "", path ="/var/www/pages/realaravinth", secret = "mytopsecretsuperlongpassword123" },
  2. If pages is deployed at and you wish to deploy changes from gh-pages branch, you can do so with the following command:

     curl -v --location --request POST '' \
    --header 'Content-Type: application/json' \
    --data-raw "{
    	\"secret\": \"$token\",
    	\"branch\": \"gh-pages\"