Expanded Readme

This commit is contained in:
Tim Schuster 2017-03-11 22:54:31 +01:00
parent 3592f42286
commit 70b12c516a
No known key found for this signature in database
GPG Key ID: F9E27097EFB77F61
1 changed files with 37 additions and 1 deletions

View File

@ -1,3 +1,39 @@
# nyx - Imageboard
A simple, dependency-free image board.
A simple, dependency-free image board.
## Requirements
* HTTPS Capable Host
* Being able to compile and run a go binary
* Disk Space
## Installation
Simply `go get` the source code or compile
it otherwise, dependencies are included.
## Usage
By default nyx works in volatile-mode,
all changes are only stored in memory and
default credentials are setup in the
database.
To overwrite these defaults, simply
create the file `config.yml` or specify
another file via the `-config` flag.
## Configuration
The configuration file is written in YAML.
The following is a list of options available;
* `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