Isso Configuration

The Isso configuration file is an INI-style textfile. You can point Isso to your configuration file either with -c path/to/isso.cfg or with a environment variable set to the absolute path.

The configuration has several sections: general for general application behavior, server to specify host and port when not using uWSGI, SMTP to send mail notifications (heavily recommended to use) and guard, a naive solution for spam and abuse detection.

Example Configuration

[general]
dbpath = /var/lib/isso/comments.db
host = https://example.tld/
[server]
port = 1234

For more information on the syntax, refer to Wikipedia: INI file

general

dbpath: location to the SQLite3 database, defaults to /tmp/isso.db (may pruned after system restart, so use a proper location).
secretkey: session key. If you restart the application several times per hour for whatever reason, use a static key. Defaults to a random string per application start.
host: location to your website or blog. When you start Isso, it will try to establish a connection to your website (a simple HEAD request). If this check fails, none can comment on your website.
max-age: time to allow users to remove or edit their comments. Defaults to 15m.

server (not applicable for uWSGI)

host: interface to listen on, defaults to localhost.
port: port to listen on, defaults to 8080.
reload: reload application, when editing the source code (only useful for developers), disabled by default.

moderation

enabled: enable comment moderation queue, disabled by default
purge-after: remove unprocessed comments in moderation queue after, by default, 30d.

SMTP

username: self-explanatory
password: self-explanatory (yes, plain text, create a dedicated account for notifications.
host: server host, defaults to localhost.
port: server port, defaults to 465.
ssl: use SSL, defaults to on.
to: recipient address
from: sender address

guard

enabled: defaults to on.

2.1 KiB Raw Blame History