add reminders through a simple API

go get



Use REM to send reminders to yourself, or someone else.

Just run the REM daemon on your server then go to the URL with your browser or POST to the API instead.

Rem uses the GNU Coreutils date command in the background, so you can use its syntax when choosing a datetime. Notifications will be sent to your smartphone if you are using the Pushover service.


Let's assume you own the domain and you're using Uberspace as your hosting provider. You're user name is bob, the document root is located at /home/bob/ and you want to run REM on

1. Clone this github repo then edit the rem.conf config file

Using Uberspace

  • login via ssh and clone the repo to your document root
[user@spica ~]$ git clone ~/ && cd ~/

2. Customise the config file

  • customise rem.conf.example then copy it into ~/.config/rem/rem.conf.
[user@spica ~/]$ mkdir -p ~/.config/rem
[user@spica ~/]$ vim rem.conf.example # Configure it to suit your needs
[user@spica ~/]$ cp rem.conf.example ~/.config/rem/rem.conf && cat ~/.config/rem/rem.conf
    "ApiToken": "n1VrLLmRMPStaX3pA8TPdh2Kl2QS3q", # Needed for the Notification Service
    "ApiUser": "cf3YtkHfnSQkYb8GTWSZuPrddTPymQ", # Needed for the Notification Service
    "DocumentRoot": "/home/bob/",
        "NotificationApi": "",
    "Path": "/rem",
    "Port": ":42888"

3. Configure HTTP Proxying

  • If using Uberspace simply add an .htaccess file to your Document Root
[user@spica ~/]$ cat /home/bob/
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteCond %{ENV:HTTPS} !=on
RewriteRule .* https://%{SERVER_NAME}%{REQUEST_URI} [R=301,L]
RewriteRule ^rem/(.*) http://localhost:42888/$1 [P]