.. author:: hendrikmaus <https://github.com/hendrikmaus>

.. tag:: lang-go

.. tag:: web

.. tag:: blog

Logo

.. tag_list::

Commento is an open source, fast, privacy-focused commenting platform written in golang.

Install and configure a :lab:`Postgresql <guide_postgresql>` server.

Since Commento provides pre-compiled binaries, we can use those:

[isabell@stardust ~]$ mkdir commento
[isabell@stardust ~]$ cd commento
[isabell@stardust commento]$ wget https://commento-release.s3.amazonaws.com/commento-linux-amd64-v1.7.0.tar.gz
[isabell@stardust commento]$

Extract the tar archive:

[isabell@stardust commento]$ tar -xf commento-linux-amd64-v1.7.0.tar.gz
[isabell@stardust commento]$

We do not need the tarball any longer, so delete it:

[isabell@stardust commento]$ rm commento-linux-amd64-v1.7.0.tar.gz
[isabell@stardust commento]$

You will be left with a single executable binary, called commento as well as supporting files.

Make sure to have your PostgreSQL credentials ready. You will need an existing database, port, username and password.

Create ~/bin/commento_daemon and add the following content:

#!/bin/sh
set -ue

export COMMENTO_ORIGIN=https://isabell.uber.space
export COMMENTO_PORT=31380
export COMMENTO_BIND_ADDRESS="0.0.0.0"
export COMMENTO_POSTGRES=postgres://<username>:<password>@<host>:<port>/<database>?sslmode=disable
exec ~/commento/commento

Make your script executable:

[isabell@stardust ~]$ chmod +x ~/bin/commento_daemon
[isabell@stardust ~]$

Create ~/etc/services.d/commento.ini with the following content:

[program:commento]
command=%(ENV_HOME)s/bin/commento_daemon

To stop and start the daemon to perform maintenance tasks, you can use supervisorctl stop and supervisorctl start, respectively:

[isabell@stardust ~]$ supervisorctl stop commento
commento: stopped
[isabell@stardust ~]$

[isabell@stardust ~]$ supervisorctl start commento
commento: started
[isabell@stardust ~]$

Check out the :manual:`supervisord manual <daemons-supervisord>` for further details.

Now you should be able to access Commento at your defined domain in your browser.

If you are the only user of the Commento instance, it would be advisable to disable the new owner sign up, after you registered your site. Add this to your commento_daemon above the /home/isabell/commento/commento call:

export COMMENTO_FORBID_NEW_OWNERS=true

Then restart Commento:

[isabell@stardust ~]$ supervisorctl restart commento
commento: stopped
commento: started
[isabell@stardust ~]$

The form to sign up will still be visible, but cannot be submitted.

---

Tested with Commento 1.7.0 / Uberspace 7.3.6.1

.. author_list::