This documentation site is about the unstable (upcoming) Comentario version.  Switch to the stable version »

Installation

How to self-host Comentario

This page explains how you can self-host Comentario.

You can install Comentario locally or deploy it somewhere on the Internet.

Depending on your needs, Comentario can be installed and run in a number of ways:

  • From a binary package: locally. This will require a manual HTTPS (SSL) configuration.
  • Into a Kubernetes cluster: using its Helm chart. This is the most straightforward way to deploy Comentario if you have Kubernetes.
  • Using a Docker image. This might prove a bit more involved, especially when in comes to HTTPS (SSL) configuration.
  • By building from source code: the hard way.

If you’re upgrading from a previous Comentario version, or upgrading from Commento/Commento++, we’ve covered that, too — make sure to check the Migration section.

Requirements

Please read this first: this page explains what you’ll need to self-host a Comentario instance.

Binary package

This page explains how you can install Comentario locally using a binary package.

Helm chart

You can easily deploy Comentario into a Kubernetes cluster using a Helm chart.

Docker image

Comentario automated build pipeline creates and uploads Docker images to GitLab Container Registry.

Building Comentario

This page explains how you can build Comentario frontend (UI) and backend (server) from its source code.

Embedding

The whole point of using Comentario is allowing your website or application users to read and write comments. You add this functionality to your pages by embedding a Comentario web component.

You can follow the generic instructions on adding Comentario HTML snippet, or pick one that applies to your situation from the list below.

Migration

Comentario is a production-ready system, which can replace a number of other services. It also supports upgrading from a previous Comentario version.