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 naive Installing this way can allow you to grok the most important commands for later installations. approach at installing. I’m using Alpine Alpine Linux version 3.10.0 Linux, but the distribution doesn’t matter.

In essence the installation process can be distilled 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 package Since isso version 0.12.6. build.

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 create an example isso.conf, run isso, and test Running isso and testing some endpoints. 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 dependencies 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