OpenGuestbook/README.md

📖 OpenGuestbook

OpenGuestbook is a self-hosted lightweight Guestbook for small static websites made using python and flask. OpenGuestbook does not use databases or an admin panel for managing entries. Instead it saves each guestbook entry as a file with a human readable format in a /guestbook folder in your server. The comments can be moderated by deleting or editing files manually.

Features

• No login required
• No database required
• Limited total comments per day.
• Easy setup, and low CPU and RAM use.
• Privacy Friendly: No tracking, no cookies, AD blocker friendly.
• Notification support via Notfy.sh!

Deployment

OpenGuestbook comes in two parts, a backend that needs to be hosted on a server, and a JS file that cn be embedded directly on your website.

Backend deployment with Docker

For production, running via Docker Compose is recommended.

1) Create docker-compose.yml

version: '3.8'
services:
  guestbook:
    build: .
    container_name: OpenGuestbook
    restart: always
    ports:
      - "5000:5000"
    volumes:
      - ./guestbook_data:/openguestbook/guestbook # Persist comments on host to make it easily reachable
    environment:
      - FRONTEND_URL=<https://yourwebsite.com> # if a frontend url is not provided the app will default the allow all utl's which is not recommended!
      - NTFY_TOPIC=<enter-ntfy-topic> # for psuh notification support (optional)

Dependencies

Configuration