Introduction
Remark42 is a self-hosted, lightweight, and simple (yet functional) comment engine, which doesn't spy on users. It can be embedded into blogs, articles or any other place where readers add comments.
https://github.com/umputun/remark42
This tutorial will walk you through setting up Remark42 on Ubuntu with Apache2 and Docker.
Prerequisites
If you haven't install Docker
sudo snap install docker
Official Guide: https://github.com/umputun/remark42#install
Copy provided docker-compose.yml and customize for your needs. You can create a folder first and paste the docker-compose.yml inside the folder. Source: https://github.com/umputun/remark42/blob/master/docker-compose.yml
Here is my docker-compose.yml.
version: '2'
services:
remark:
build: .
image: umputun/remark42:latest
container_name: "remark42"
restart: always
logging:
driver: json-file
options:
max-size: "10m"
max-file: "5"
ports:
- "8888:8080"
environment:
- REMARK_URL=https://remark42.tatlead.com
- ALLOWED_HOSTS=www.tatlead.com
- SITE=tatlead
- SECRET=*******
- STORE_BOLT_PATH=/srv/var/db
- BACKUP_PATH=/srv/var/backup
- DEBUG=true
- AUTH_GOOGLE_CID
- AUTH_GOOGLE_CSEC
- AUTH_GITHUB_CID=*******
- AUTH_GITHUB_CSEC=*******
- AUTH_FACEBOOK_CID
- AUTH_FACEBOOK_CSEC
- AUTH_DISQUS_CID
- AUTH_DISQUS_CSEC
- ADMIN_SHARED_ID
# - ADMIN_PASSWD=password
volumes:
- ./var:/srv/var
Pull the umputun/remark42:latest image from the DockerHub
docker-compose pull
Start
docker-compose up -d
Your remark42 server is running on http://127.0.0.1:8888/ 👏
Setup Apache2 reverse proxy
Goto /etc/apache2/sites-enabled/, create or edit a .conf file. We will create the file on this example.
sudo nano remark42.conf
My .conf settings
<VirtualHost *:443>
ServerName remark42.tatlead.com
ProxyRequests Off
ProxyPreserveHost On
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
Header unset X-Frame-Options
Header edit Set-Cookie ^(XSRF-TOKEN=.*);.?[h|H].+(;.*)$ "$1$2"
ProxyPass / http://127.0.0.1:8888/
ProxyPassReverse / http://127.0.0.1:8888/
SSLEngine on
SSLProxyEngine On
Include *******
SSLCertificateFile *******
SSLCertificateKeyFile *******
</VirtualHost>
Header unset X-Frame-Options is set because X-Frame-Options is default to SAMEORIGIN. Unset the X-Frame-Options allows the remark42 widget iframe display on all sites. You should set the docker-compose.yml's ALLOWED_HOSTS environment variable to restrict the allowed hosts instead.
Header edit Set-Cookie ^(XSRF-TOKEN=.*);.?[h|H].+(;.*)$ "$1$2" is a line to remove the HttpOnly attribute on the XSRF-TOKEN cookie. In my case, XSRF-TOKEN cookie is always set to HttpOnly (not sure why), it causes remark42 cannot read the xsrf token properly and cause xsrf mismatch error. If you doesn't have this issue, you may remove this line.
ProxyPass and ProxyPassReverse should be point to the remark42 server which is http://127.0.0.1:8888/ in this example.
Restart Apache2
Restart apache2 to apply the changes
sudo service apache2 restart
Visit https://<your_remark42_domain>/web on your browser to check it works or not.
Working Example: https://remark42.tatlead.com/web
Base on https://github.com/lh1me/hexo-theme-aomori#remark42
Edit the _config.yml, the site_id should be the same as the value on the docker-compose.yml's SITE environment variable.
aomori_remark42:
enable: true
host: https://remark42.tatlead.com
site_id: tatlead
max_shown_comments: 10
theme: light
locale: en
show_email_subscription: false
