Here’s how I use Comentario with Caddy.

Comentario docker-compose.yml file:

services:
  comentario-db:
    image: postgres:17-alpine
    container_name: comentario-db
    environment:
      POSTGRES_DB: comentario
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - ./db:/var/lib/postgresql/data
    restart: always
    networks:
      - caddy

  comentario:
    image: registry.gitlab.com/comentario/comentario
    container_name: comentario
    environment:
      BASE_URL: https://comments.yourdomain.com/
      SECRETS_FILE: "/secrets.yaml"
    volumes:
      - ./secrets.yaml:/secrets.yaml:ro
    restart: always
    depends_on:
      - comentario-db
    networks:
      - caddy
networks:
  caddy:
    external: true

Here’s the Caddyfile entry:

My first attempt at a blog site involved trying to self-host a Wordpress site. For my purposes, this was massive overkill. I didn’t need the plug-ins, style customization, and general complexity. I just wanted a simple blog. So, Hugo was a great fit for my needs. If you want a good tutorial on how to set up workflow from Obsidian to Hugo, check out Network Chuck’s instructions on his blog .

The Subfolder Problem

For anyone who’s tried hosting a website from the subfolder, e.g., https://www.example.com/blog, you know that this can often lead to issues like broken links or incorrectly styled elements. This is due to many frameworks assuming you are hosting out of the root of the web site. While Hugo has a way to configure a site for this, there are some things you may need to adjust in order to make it work.