From 6e02c7dd2ac8ddf887a826dd6afb11c8b4d05c85 Mon Sep 17 00:00:00 2001 From: Azareal Date: Wed, 20 Feb 2019 15:35:18 +1000 Subject: [PATCH] Added the configuration documentation file. --- docs/configuration.md | 107 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 docs/configuration.md diff --git a/docs/configuration.md b/docs/configuration.md new file mode 100644 index 00000000..839ca4e5 --- /dev/null +++ b/docs/configuration.md @@ -0,0 +1,107 @@ +# Configuration + +For configuring the system, Gosora has a file called `config/config.json` which you can tweak to change various behaviours, it also has a few settings in the Setting Manager in the Control Panel. + +The configuration file has four categories you may be familiar with from poring through it's contents. Site, Config, Database and Dev. + +Site is for critical settings, Config is for lower priority yet still important settings, Database contains the credentials for the database (you will be able to pass these via parameters to the binary in a future version), and Dev is for a few flags which help out with the development of Gosora. + +An example of what the file might look like: https://github.com/Azareal/Gosora/blob/master/config/config_example.json + +# Site + +ShortName - A two or three letter abbreviation of your site's name. Intended for compact spaces where the full name is too long to squeeze in. + +Name - The name of your site, as appears in the title, some theme headers and search engine search results. + +URL - The URL for your site. Please leave out the `http://` or `https://` and the `/` at the end. + +Port - The port you want Gosora to listen on. This will usually be 443 for HTTPS and 80 for HTTP. Gosora usually try to bind to both, if you're on HTTPS to redirect users from the HTTP site to the HTTPS one. + +EnableSsl - Determines whether HTTPS is enabled. + +EnableEmails - Determines whether the SMTP mail subsystem is enabled. The experimental plugin sendmail also allows you to send emails without SMTP in a similar style to some languages like PHP, although it only works on Linux and has some issues. + +HasProxy - Brittle, but lets you set whether you're sitting behind a proxy like Cloudflare. Unknown effects with reverse-proxies like Nginx. + +Language - The language you want to use. Defaults to english. Please consult [internationalisation](https://github.com/Azareal/Gosora/blob/master/docs/internationalisation.md) for details. + +# Config + +SslPrivkey - The path to the SSL private key. Example: ./cert/test.key + +SslFullchain - The path to the fullchain SSL certificate. Example: ./cert/test.cert + +SMTPServer - The domain for the SMTP server. May be left blank if EnableEmails is false. + +SMTPUsername - The username for the SMTP server. + +SMTPPassword - The password for the SMTP server. + +SMTPPort - The port for the SMTP server, usually 25. + +MaxRequestSizeStr - The maximum size that a request made to Gosora can be. This includes uploads. Example: 5MB + +UserCache - The type of user cache you want to use. You can leave this blank to disable this feature or use `static` for a small in-memory cache. + +TopicCache - The type of topic cache you want to use. You can leave this blank to disable this feature or use `static` for a small in-memory cache. + +UserCacheCapacity - The maximum number of users you want in the in-memory user cache, if enabled in the UserCache setting. + +TopicCacheCapacity - The maximum number of topics you want in the in-memory topic cache, if enabled in the TopicCache setting. + +DefaultPath - The route you want the homepage `/` to default to. Examples: `/topics/` or `/forums/` + +DefaultGroup - The group you want users to be moved to once they're activated. Example: 3 + +ActivationGroup - The group you want users to be placed in while they're awaiting activation. Example: 5 + +StaffCSS - Classes you want applied to the postbits for staff posts. This setting is deprecated and will likely be replaced with a more generic mechanism in the near future. + +DefaultForum - The default forum for the drop-down in the quick topic creator. Please note that FID 1 is reserved for the default reports forum. Example: 2 + +MinifyTemplates - Whether you want the HTML pages to be minified prior to being send to the client. + +BuildSlugs - Whether you want the title appear in the URL. For instance: `/topic/traffic-in-paris.5` versus `/topic/5` + +ServerCount - The number of instances you're running. This setting is currently experimental. + +NoAvatar - The default avatar to use for users when they don't have their own. The default for this may change in the near future to better utilise HTTP/2. Example: https://api.adorable.io/avatars/{width}/{id}.png + +ItemsPerPage - The number of posts, topics, etc. you want on each page. + +# Database + +Adapter - The name of the database adapter. `mysql` and `mssql` are options, although mssql may not work properly in the latest version of Gosora. PgSQL support is in the works. + +Host - The host of the database you wish to connect to. Example: localhost + +Username - The username for the database you wish to connect to. Example: root + +Password - The password for the database you wish to connect to. Example: password + +Dbname - The name of the database you want to use. Example: gosora + +Port - The port the database is listening on. Usually 3306 for MySQL. + +TestAdapter - A test version of Adapter. Only used for testing purposes. + +TestHost - A test version of Host. Only used for testing purposes. + +TestUsername - A test version of Username. Only used for testing purposes. + +TestPassword - A test version of Password. Only used for testing purposes. + +TestDbname - A test version of Dbname. Only used for testing purposes. + +TestPort - A test version of Port. Only used for testing purposes. + +# Dev + +DebugMode - Outputs a basic level of information about what Gosora is doing to help ease debugging. + +SuperDebug - Outputs a detailed level of information about what Gosora is doing to help ease debugging. Warning: This may cause severe slowdowns in Gosora. + +TemplateDebug - Output a detailed level of information about what Gosora is doing during the template transpilation step. Warning: Huge amounts of information will be dumped into the logs. + +NoFsnotify - Whether you want to disable the file watcher which automatically reloads assets whenever they change. \ No newline at end of file