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:
services:
  db:
    image: postgres:17-alpine
    environment:
      POSTGRES_DB: comentario
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "postgres"]
      timeout: 5s
      retries: 5
      start_period: 10s

  app:
    image: registry.gitlab.com/comentario/comentario
    environment:
      BASE_URL: http://localhost:8080/
      SECRETS_FILE: "/secrets.yaml"
    ports:
      - "8080:80"
    healthcheck:
      test: ["CMD", "wget", "-O", "-", "http://localhost/api/user"]
      timeout: 5s
      retries: 5
      start_period: 5s
    depends_on:
      db:
        condition: service_healthy
    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.

Tags: ,