diff options
| author | Vosjedev <vosje@vosjedev.net> | 2025-11-02 13:56:44 +0100 |
|---|---|---|
| committer | Vosjedev <vosje@vosjedev.net> | 2025-11-02 13:56:44 +0100 |
| commit | f2ebbb7e9221eceefa457961dd4b32319807d737 (patch) | |
| tree | beb06f444fd07ef2f4701ed412e699dfbbbe6e3a | |
| parent | 60749b5099a8ba1d63e8cc313c451c8a4001a078 (diff) | |
| download | acit-f2ebbb7e9221eceefa457961dd4b32319807d737.tar.gz acit-f2ebbb7e9221eceefa457961dd4b32319807d737.tar.bz2 acit-f2ebbb7e9221eceefa457961dd4b32319807d737.tar.xz | |
update docs
| -rw-r--r-- | README.md | 28 |
1 files changed, 27 insertions, 1 deletions
@@ -21,9 +21,11 @@ To configure acit, use environment variables. Here's an overview of them, includ ACIT_IMAP_USER="bugs@example.com" ACIT_IMAP_PASSWD="SuperSecurePassword" ACIT_IMAP_SERVER="mail.example.com" - ACIT_IMAP_PORT=0 # if set to 0, uses default port (993) + ACIT_IMAP_PORT=993 # note we only support IMAP with Implicit TLS. # usage of IMAP using STARTTLS and unencrypted imap aren't implemented. + ACIT_IMAP_POOL_SIZE=4 # the amount of IMAP connections to make. Note at least 2 is recommended. + # a pool size of 1 can lead to it taking ridiculously long to process new email or generate pages. # # SMTP login @@ -36,6 +38,13 @@ To configure acit, use environment variables. Here's an overview of them, includ # note only SMTP using Implicit TLS is supported. # STARTTLS and unencrypted SMTP are, just like with IMAP, not implemented. +# +# Database +# -------- +MYSQL_USER=acit # username for the mariadb server +MYSQL_PASSWORD=AnotherSecurePassword # password for said server +MYSQL_DATABASE=acit # the database to use +MYSQL_HOST=localhost # the hostname/ip of the server. to define a port, use host:port syntax. # # Email matching/formatting @@ -62,6 +71,23 @@ To configure acit, use environment variables. Here's an overview of them, includ if ACIT_MAIL_DOMAIN is unset, it uses everything behind the at (@) in ACIT_IMAP_USER. DOC +# +# Settings +# -------- +ACIT_HOME_REDIRECT=about:blank # where to redirect to when someone queries the webroot + +# the following option should be the full path to an executable. +# said executable should return a table of trackers and urls. +# see #acit-list-trackers below in this README.md # TODO: write mentioned section +ACIT_LIST_TRACKERS=/usr/lib/acit-list-trackers ``` +# crawling +Acit makes use of the fact that crawlers will probably often crawl the index page for running certain tasks once in a while. If you are planning on blocking crawlers or want to ensure these tasks run regularly regardless of trackers, curl the webroot (`https://bugs.example.com/` if `bugs.example.com` is your domain) once in a while (every 5 minutes would be nice). Note some of these tasks will also happen when needing relevant resources. + +Currently these tasks include: + +- Updating the projectlist + + |
