Multiple Sites & Sub-URI

Multiple Sites

Isso is designed to serve comments for a single website and therefore stores comments for a relative URL. This is done to support HTTP, HTTPS and even domain transfers without manual intervention. 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

; /etc/isso.d/foo.example.cfg
name = foo
host = http://foo.example/
dbpath = /var/lib/isso/foo.example.db
; /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.


You can run Isso on the same domain as your website, which circumvents issues originating from CORS. Also, privacy-protecting browser addons such as Request Policy wont block comments.

server {
    listen       [::]:80;
    listen       [::]:443 ssl;
    server_name  example.tld;
    root         /var/www/example.tld;

    location /isso {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Script-Name /isso;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://localhost:8080;

Now, the website integration is just as described in Quickstart but with a different location.