0
0
mirror of https://github.com/rls-moe/nyx synced 2024-12-24 12:17:16 +00:00

Updated README

This commit is contained in:
Tim Schuster 2017-03-15 19:57:19 +01:00
parent e5cdbe7211
commit f31ae331e7
No known key found for this signature in database
GPG Key ID: F9E27097EFB77F61

View File

@ -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
* `site.description` - Site Description
* `captcha` - Captcha Mode, currently only `internal` is supported
The config accepts other options but these may not be supported.