Multiple Sites

Multiple Sites

Isso is designed to serve comments for a single website and therefore stores comments for a relative URL to support HTTP, HTTPS and even domain transfers without manual intervention. But you can chain Isso to support multiple websites on different domains.

The following example uses gunicorn as WSGI server ( you can use uWSGI as well). Let’s say you maintain two websites, like foo.example and

$ cat /etc/isso.d/foo.example.cfg
name = foo
host = http://foo.example/
dbpath = /var/lib/isso/foo.example.db

$ cat /etc/isso.d/
name = bar
host =
dbpath = /var/lib/isso/

Then you run Isso with gunicorn (separate multiple configuration files by semicolon):

$ export ISSO_SETTINGS="/etc/isso.d/foo.example.cfg;/etc/isso.d/"
$ gunicorn isso.dispatch -b localhost:8080

In your webserver configuration, proxy Isso as usual:

server {
    listen [::]:80;
    server_name comments.example;

    location / {
        proxy_pass http://localhost:8080;

When you now visit http://comments.example/, you will see your different Isso configuration separated by /name.

$ curl http://comments.example/

Just embed the JavaScript including the new relative path, e.g. http://comments.example/foo/js/embed.min.js. Make sure, you don’t mix the URLs on both sites as it will most likely cause CORS-related errors.