diff --git a/README.md b/README.md index 84dbf1e..e5ab908 100644 --- a/README.md +++ b/README.md @@ -24,16 +24,55 @@ To overwrite these defaults, simply create the file `config.yml` or specify another file via the `-config` flag. +## Hostnames + +Nyx seperates hostnames as distinct namespaces with their own content. + +At the moment you cannot port content between namespaces. + +## Administration + +The administration panel is available under `/admin/` (don't forget the trailing slash), the default login is `admin` with password `admin`. It is recommended to add a new administrator and delete the default ID. + +Here you can add boards, set board rules and start a database cleanup. + +The cleanup will remove entries older than 7 days, deleted and orphaned threads and replies. + +Once logged in as administrator you can also delete posts on the setup boards +or mark your own posts as special (though still anonymous) + +## Posting + +Posts are limited to 10k characters and uploads to 10MB including Base64 overhead (realistically you should be able to upload a 7MB file) + +Nyx includes a system called "Trollthrottle". It will rate content based on how well it compresses, it's length and number of lines and the occurence of (currently fixed) keywords. + +The end result is a spam score and a captcha probability, both displayed along +each post. The captcha probability specifies how like it is that a user +will fail a captcha despite having entered it correctly. This is capped at 99%, which means only 1 out of 100 correct solutions will be accepted. + +This systems does not stop all trolls but will make it harder for people to post spam by forcing them to do more work. + +## TripCodes + +Tripcodes are non-traditional, they are calculated as the first 8 bytes of the +Blake2b Hashsum of the entered Code in Base64 Encoding. + +Tripcodes do not offer a guarantee that a user is who they say they are as the +codes can be trivially cracked even on a mobile device. + ## Configuration The configuration file is written in YAML. -The following is a list of options available; +The following is a list of options available (and supported); -* `disable_security` - Disabled some HTTPS only options for cookies or redirects * `secret` - Secret used for User Login, CSRF and Session Management, default is `changeme` * `listen_on` - Defaults to `:8080`, specifies on which port the HTTP server is launched. Nyx will not utilize this value otherwise so proxying is safe. * `hosts` - A whitelists of hostnames that are allowed to be used. Nyx uses hostnames to differentiate several board collections. * `db.file` - File to use for data storage, defaults to `:memory:` which means in-memory storage * `site.title` - Site Title -* `site.description` - Site Description \ No newline at end of file +* `site.description` - Site Description +* `captcha` - Captcha Mode, currently only `internal` is supported + +The config accepts other options but these may not be supported. \ No newline at end of file