wonderfall/isso

What is this?

Isso is a commenting server similar to Disqus. More info on the official website.

Docker image

Docker Hub: wonderfall/isso

Docker Pull Command:

docker pull wonderfall/isso

Features

• Based on Alpine Linux 3.3.
• Latest Isso installed with pip.

Build-time variables

• ISSO_VER : version of Isso.

Environment variables

• GID : isso group id (default : 991)
• UID : isso user id (default : 991)

Volumes

• /config : location of configuration files.
• /db : location of SQLite database.

Ports

• 8080 (reverse proxy!).

8080 is exposed in this Isso Docker image.

Example of simple configuration

Here is the full documentation : https://posativ.org/isso/docs/

# cat /mnt/docker/isso/config/isso.conf
[general]
; database location, check permissions, automatically created if not exists
dbpath = /db/comments.db
; your website or blog (not the location of Isso!)
; you can add multiple hosts for local development
; or SSL connections. There is no wildcard to allow
; any domain.
host = https://www.example.com/
notify = smtp

[server]
listen = http://0.0.0.0:8080/

[guard]
enabled = true
ratelimit = 2
direct-reply = 30
reply-to-self = false
require-author = true
require-email = true

[smtp]
host = smtp.gmail.com
port = 465
security = ssl
username = <username>
password = <password>
to = <email address>
from = "ISSO Comment System" <no-reply@example.com>
timeout = 10

# cat /etc/nginx/sites-available/isso
...
server {

  server_name comments.example.com; #serve the Isso system with a dedicated domain

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

  ...

}
...

Run the Isso Docker Image as a Container:

docker run --name isso -v /mnt/docker/isso/config:/config -v /mnt/docker/isso/db:/db -p 8080:8080 --rm -d wonderfall/isso

Get started with Docker Compose:

# pwd
/var/www/dockerize_isso
# ls
config  db  docker-compose.yml
# cat docker-compose.yml
isso:
  image: wonderfall/isso
  environment:
    - GID=1000
    - UID=1000
  ports:
    - "8080:8080"
  volumes:
    - ./config:/config
    - ./db:/db

Test Isso:

https://comments.example.com/js/embed.min.js

Paste the script code below in your website:

<script data-isso="//comments.example.com/"
  data-isso-css="true"
  data-isso-lang="zh"
  data-isso-reply-to-self="false"
  data-isso-require-author="true"
  data-isso-require-email="true"
  data-isso-max-comments-top="10"
  data-isso-max-comments-nested="5"
  data-isso-reveal-on-click="5"
  data-isso-avatar="true"
  data-isso-avatar-bg="#f0f0f0"
  data-isso-avatar-fg="#9abf88 #5698c4 #e279a3 #9163b6 ..."
  data-isso-vote="true"
  data-vote-levels=""
  src="//comments.example.com/js/embed.min.js"></script>
<section id="isso-thread"></section>
<noscript>请开启 JavaScript 查看 <a href="https://posativ.org/isso/" rel="nofollow">isso 评论系统的内容</a>。</noscript>

Done.

---

Isso in subdirectory

We can also host Isso system in a subdirectory isso but not a dedicated domain, like www.example.com/isso, in this case, we need to update the Nginx configuration this way:

# cat /etc/nginx/sites-available/isso
...
server {

  server_name comments.example.com;

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

}
...

And the script code:

<script data-isso="//www.example.com/isso/"
  data-isso-css="true"
  data-isso-lang="zh"
  data-isso-reply-to-self="false"
  data-isso-require-author="true"
  data-isso-require-email="true"
  data-isso-max-comments-top="10"
  data-isso-max-comments-nested="5"
  data-isso-reveal-on-click="5"
  data-isso-avatar="true"
  data-isso-avatar-bg="#f0f0f0"
  data-isso-avatar-fg="#9abf88 #5698c4 #e279a3 #9163b6 ..."
  data-isso-vote="true"
  data-vote-levels=""
  src="//www.example.com/isso/js/embed.min.js"></script>
<section id="isso-thread"></section>
<noscript>请开启 JavaScript 查看 <a href="https://posativ.org/isso/" rel="nofollow">isso 评论系统的内容</a>。</noscript>

How to delete comments with commands?

# sudo apt-get update
...
# sudo apt-get install sqlite sqlite3 libsqlite3-dev
...
# cd /mnt/docker/isso/db/
# sqlite3
sqlite> ATTACH 'comments.db' as isso;
sqlite> .tables
isso.comments     isso.preferences  isso.threads
sqlite>
sqlite> .show
...
sqlite> .headers ON
sqlite> .mode column
sqlite> SELECT * from isso.comments;
...
sqlite> SELECT * from isso.threads;
...
sqlite> SELECT id,author,text from isso.comments;
...
sqlite> DELETE FROM isso.comments WHERE id=87;
...
sqlite> .quit

Reference: Command Line Shell For SQLite