Installing Isso From Source
Isso is a lightweight open source commenting server. Sometimes changes to an open source program can take a while to make it into a packaged version. Let’s install Isso from source and get the latest fixes and features.
The documentation can be tricky. Here’s my Installing this way can allow you to grok the most important commands for later installations. approach at installing. I’m using Alpine Linux version 3.10.0 Linux, but the distribution doesn’t matter.
In essence the installation process can be Don't forget to create a separate user for Isso. to these crucial commands.
mkdir /opt/isso
cd /opt/isso
git clone https://github.com/posativ/isso .
python3 -m venv .
source bin/activate
python setup.py develop
npm install bower requirejs jade
PATH=$PATH:/opt/isso/node_modules/.bin
make init
make js
touch isso.conf
isso --version
Then we create an example isso.conf, run isso, and
some endpoints to make sure it is working.
# Isso configuration file
# vim: set filetype=ini
[general]
dbpath = /opt/isso/isso-comments.db
name = example.com
host = https://example.com/
max-age = 15m
notify = stdout
[admin]
enabled = true
password = changethis
[moderation]
enabled = false
purge-after = 30d
[server]
reload = off
profile = off
listen = http://127.0.0.1:8100
#public-endpoint = https://example.com/isso
[smtp]
username =
password =
host = localhost
port = 587
security = starttls
to =
from =
timeout = 10
[guard]
enabled = true
ratelimit = 2
direct-reply = 3
reply-to-self = false
require-email = false
require-author = false
[markup]
options = strikethrough, autolink, fenced_code, no_intra_emphasis
allowed-elements =
allowed-attributes =
[hash]
salt = GkSOkjoIPI2GvAlnxwUsMiwn
algorithm = pbkdf2
If you’re trying this on Alpine Linux, then the following These vary across different distributions, but can be cross referenced without much ado. are needed.
apk add git python3 gcc python3-dev musl-dev libffi-dev npm make
Updated 30 November 2019