AppMini Clerk Save

Self-hosted habit tracker and event logging web app.

Project README

Track periodic events in your life such as when baby has a nappy change, when you eat chocolate, or how many hours you slept.


  • Web based.
  • Easy to deploy.
  • Self-hosted & FLOSS.
  • Simple text based CSV format.
  • Allows multiple people to log events.
  • Mobile friendly - "Add to Home Screen" web-app.


  • Download a release or git clone the master branch.
  • Copy the files to your PHP web hosting.

To require authentication, first create a password file:

htpasswd -c /path/to/.htpasswd username

Then copy ./example.htaccess to .htaccess and edit it.

Data format

Screenshot 2

For every event logged the event type, timestamp, and comment are stored.

Events are stored in individual CSV files - one file per event type.

You can also download all CSVs stiched together with an extra column for the event name.


If you have multiple users, clone the app folder for each user and create a unique htaccess login for each.

To create shared events either symlink one of the CSV files into each user's data directory or symlink the entire data folder.


The server is written in mal/php which is a Clojure-like implementation on PHP.


Copyright Chris McCormick, 2017. GPLv3 licensed.

Open Source Agenda is not affiliated with "AppMini Clerk" Project. README Source: AppMini/Clerk
Open Issues
Last Commit
3 years ago

Open Source Agenda Badge

Open Source Agenda Rating