Why?
When I was using flatpress, there was a possibility to leave comments. But since hugo generates a static website, it does not support comments. But there is isso, which adds comments to a static site like hugo.
Debian package
Because there is now a debian package available for buster, I installed isso from the default repository. I followed a great write-up to setup everything. In the write-up it starts with running isso manually. When I did this everything was working as expected. But when I started isso from systemd (with the files supplied by the debian package) it failed. Because of this, I created a bug report to get a fix. In the meantime I used the systemd file mentioned in the write-up to get it working.
Configuration setup
In the Debian release there is a /etc/isso.d/enabled/ directory where
the enabled configuration should be placed. This directory is similar to
the sites-enabled and mods-enabled which are used by apache2 on Debian.
So I created a new file called
/etc/isso.d/available/blog.stefan.ubbink.org.cfg for my blog with the
following content (without comments):
[general]
name = blog.stefan.ubbink.org
dbpath = /var/lib/isso/blog.stefan.ubbink.org.db
host =
http://blog.stefan.ubbink.org/
https://blog.stefan.ubbink.org/
max-age = 15m
notify = smtp
log-file = /var/log/isso/isso.log
[server]
listen = http://localhost:8000
public-endpoint = https://blog.stefan.ubbink.org/isso
[moderation]
enabled = true
[smtp]
host = nynaeve.aybara.org
port = 25
security = none
to = Stefan (admin) <*******@tigerp.net>
from = isso comment <*******@aybara.org>
[guard]
enabled = true
ratelimit = 2
direct-reply = 3
reply-to-self = false
require-author = true
[markup]
[admin]
enabled = true
password = **********
And to enable this configuration I created a symlink in the enabled directory.
cd /etc/isso.d/enabled
ln -s /etc/isso.d/available/blog.stefan.ubbink.org.cfg
You might have noticed that configure isso to listen on port 8000 at localhost. This information is used to configure apache to pass request for /isso to the isso process in the blog virtualhost.
ProxyPreserveHost On
ProxyPass /isso http://127.0.0.1:8000
ProxyPassReverse /isso http://127.0.0.1:8000
To be get isso running when the system is restarted, I had to create my
own systemd file in /etc/systemd/system/isso.service (without
comments):
[Unit]
Description=Isso Comments
After=network.target
[Service]
User=isso
Group=nogroup
LimitNOFILE=16384
LimitNPROC=16384
LimitLOCKS=16384
ExecStart=/usr/bin/isso -c /etc/isso.d/enabled/blog.stefan.ubbink.org.cfg run
Restart=on-failure
StartLimitInterval=600
[Install]
WantedBy=multi-user.target
After starting this systemd service, isso was working and now you can leave comments about my blogs.