ansible-role-isso/README.md

Isso commenting system - ansible role

Depends on nginx role, yet to be released.

Settings:

isso_user: "isso"
isso_user_home: "/home/{{ isso_user }}"
isso_db_dir: "{{ isso_user_home }}/dbs"
isso_dbpath: "{{ isso_db_dir}}/isso-comments.db"
# Don't change this, tied to prebuilt isso-{version}.tar.gz!
#isso_version:
isso_virtualenv: "{{isso_user_home}}/.virtualenvs/py39"
isso_python_version: "3.9"
isso_log_dir: "/var/log/isso"
isso_hosts:
  - http://localhost # Use https for this...
isso_admin_password:
isso_moderation_purge_after: '364d'
isso_server_port: 8080
isso_server_listen: "http://0.0.0.0:{{ isso_server_port }}"
# Important to set this!
isso_server_public_endpoint:
isso_server_trusted_proxies: "127.0.0.1"
# Don't use ISSO_CORS_ORIGIN unless you know exactly what you are doing!
# The isso docs are wrong on this!
#isso_cors_origin: # e.g. "*.example.test"

# CSP - Content Security Policy headers - only reporting URI relevant
isso_csp_report_uri: "{{csp_report_uri}}"

# Telegram integration
# Only available in forked Isso
isso_notify_telegram: false
isso_telegram_token:
isso_telegram_chatid:

# Use a customized ("ix5") version:
isso_use_customized_pkg: false
# Use pip install from PyPI (if false: use files/isso-verX.tar.gz)
isso_use_pypi: true

# Only allow access to admin from within WireGuard network
isso_restrict_admin_wg: false
isso_restrict_admin_wg_ip: 0.0.0.0

(See default/main.yml)

Packaging Isso

cd <isso-dir>
make init all
python3 setup.py sdist

The Isso python package will be in dist/isso<ver>.tar.gz. Copy to files/isso-<ver>tar.gz and increment isso_version.

Modifications used to build the customized package can be found at ix5/isso:private/ix5-modifications.

License

GPLv2