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

Docker playground

You can easily try Comentario out with Docker

The easiest way to give Comentario a spin is using Docker with its Compose plugin. You won’t need anything else to try it out.

You will need to create the following two files.

  • docker-compose.yml:
version: '3'

services:
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: comentario
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    ports:
      - "5432:5432"

  app:
    image: registry.gitlab.com/comentario/comentario:v3.8.0
    environment:
      BASE_URL: http://localhost:8080/
      SECRETS_FILE: "/secrets.yaml"
    ports:
      - "8080:80"
    volumes:
      - ./secrets.yaml:/secrets.yaml:ro
  • secrets.yaml (find more details in Secrets):
postgres:
  host:     db
  port:     5432
  database: comentario
  username: postgres
  password: postgres

The two files must reside in the same directory. Then, start the database and the backend using:

docker compose up

Comentario will be reachable at localhost:8080. Just navigate to Sign up and register with any email and password: you’ll become a superuser and will be able to configure the server and add domains in the UI.