Installing Isso From Source

Top level Isso source directory
Isso GitHub repository

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.

Animated install procedure
Blind isso Install

In essence the installation process can be Don’t forget to create a separate user for isso. to the following crucial commands. In later versions, you won’t need to contort so much when building isso since the necessary JavaScript files are built during the python Since isso version 0.12.6. build.

mkdir /opt/isso
cd /opt/isso
git clone .
python3 -m venv .
source bin/activate
python develop
npm install bower requirejs jade
make init
make js
touch isso.conf
isso --version

Then create an example isso.conf, run isso, and Running
isso and testing some endpoints. Running isso and testing some endpoints. some endpoints to make sure it is working.

# Isso configuration file
# vim: set filetype=ini

dbpath = /opt/isso/isso-comments.db
name =
host =
max-age = 15m
notify = stdout

enabled = true
password = changethis

enabled = false
purge-after = 30d

reload = off
profile = off
listen =
#public-endpoint =

username =
password =
host = localhost
port = 587
security = starttls
to =
from =
timeout = 10

enabled = true
ratelimit = 2
direct-reply = 3
reply-to-self = false
require-email = false
require-author = false

options = strikethrough, autolink, fenced_code, no_intra_emphasis
allowed-elements =
allowed-attributes =

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