Introduction

GitPigeon is a self-hosted comment system that stores comments in your own Git repository. The server is a write gateway and a redacting proxy: no database, no user system, no admin panel.

How it differs from Twikoo / Waline

Twikoo, Waline and Artalk all require a database. GitPigeon does not. The truth lives in Git.

GitPigeonTraditional
Storageyour Git repositorydatabase
Migrationgit cloneexport / import
Moderationemail plus one clickadmin panel
Read pathproxy functiondirect query
Visibility delayabout 60 secondsrealtime

Three core decisions

  1. The server is a write gateway plus a redacting proxy. Stateless, no sessions, no database.
  2. Reads always go through the function. Encrypted emails are stripped before any response leaves the server.
  3. The blog does not rebuild because of comments. Reading is a live GET /api/comments.

Next steps