a
/
gosora
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
gosora/docs/configuration.md

190 lines
11 KiB
Markdown
Raw Normal View History

Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
# 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.
Added the Plugin section to config.json Added support for ZIP files to the backups route. The post counter won't be incremented if json marshalling fails now. Added the router_pre_route hook. Added the router_end hook. Added the action_end_create_topic hook. Added the action_end_create_reply hook.
2019-04-06 01:08:49 +00:00
The configuration file has five categories you may be familiar with from poring through it's contents. Site, Config, Database, Dev and Plugin.
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
Added the Plugin section to config.json Added support for ZIP files to the backups route. The post counter won't be incremented if json marshalling fails now. Added the router_pre_route hook. Added the router_end hook. Added the action_end_create_topic hook. Added the action_end_create_reply hook.
2019-04-06 01:08:49 +00:00
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).
Dev is for a few flags which help out with the development of Gosora.
Plugin which you may not have run into is a category in which plugins can define their own custom configuration settings.
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
An example of what the file might look like: https://github.com/Azareal/Gosora/blob/master/config/config_example.json
add emoji docs
2020-07-15 09:03:10 +00:00
Other configuration files: [config/weakpass.json](https://github.com/Azareal/Gosora/blob/master/docs/weak_passwords.md), [config/emoji.json](https://github.com/Azareal/Gosora/blob/master/docs/emoji.md) (WIP)
docs for weakpass.json grammar add a weakpass literal
2020-06-19 03:03:10 +00:00
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
# 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.
Added information about the Email, DisableLiveTopicList, DisableJSAntispam, MaxTopicTitleLength and MaxUsernameLength configuration settings to configuration.md
2019-02-21 06:52:32 +00:00
Email - The email address you want to show up in the From: field when Gosora sends emails. May be left blank, if emails are disabled.
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
URL - The URL for your site. Please leave out the `http://` or `https://` and the `/` at the end.
The router now redirects requests to localhost domains with localhost equivalents in the host header which don't quite match the destination to the proper domain. The router now rejects host headers with the wrong port for non-standard ports. The www. redirect now handles non-standard ports properly. The Site.Port configuration setting is now validated on start-up to ensure it's a valid integer. Quickly fixed up the grammar of the Port block in configuration.md
2019-04-01 05:44:38 +00:00
Port - The port you want Gosora to listen on. This will usually be 443 for HTTPS and 80 for HTTP. Gosora will try to bind to both, if you're on HTTPS to redirect users from the HTTP site to the HTTPS one.
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
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.
Activation tokens should work again now. Document the SMTPEnableTLS setting and update the documentation for SMTPPort.
2019-03-03 06:10:26 +00:00
SMTPPort - The port for the SMTP server, usually 25 or 465 for full TLS.
SMTPEnableTLS - Enable TLS to fully encrypt the connection between Gosora and the SMTP server.
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
You can now disable the search subsystem. Try Travis with MariaDB 12...
2019-02-23 06:55:34 +00:00
Search - The type of search system to use. Options: disabled, sql (default)
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
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.
Added a small reply cache. Preloaded a small number of users and topics. Use cache.Set instead of cache.Add in a few spots for topics to avoid issues with the counter falling out of sync with the cache length. Embed Reply in ReplyUser instead of duplicating the same fields. Add the missing AttachCount and ActionType fields to Reply. Add the missing Poll field to TopicsRow. Added the TopicUser.Replies method to better abstract the reply list generation logic. Shortened some common.s to c.s Moved memStuff out of the analytics memory panes and into analytics.js Removed the temporary preStats fix for label overflow now that we have a better solution. Added the panel_analytics_script_memory template to help de-dupe logic in the analytics memory panes. Added the Topic method to TopicsRow. Added the GetRidsForTopic method to help cache replies in a small set of scenarios. Added the ReplyCache config.json setting. Added the ReplyCacheCapacity config.json setting. Added a parser test case. Added more Reply and ReplyStore related test cases.
2019-05-17 08:40:41 +00:00
ReplyCache - The type of reply cache you want to use. You can leave this blank to disable this feature or use `static` for a small in-memory cache.
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
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.
Added a small reply cache. Preloaded a small number of users and topics. Use cache.Set instead of cache.Add in a few spots for topics to avoid issues with the counter falling out of sync with the cache length. Embed Reply in ReplyUser instead of duplicating the same fields. Add the missing AttachCount and ActionType fields to Reply. Add the missing Poll field to TopicsRow. Added the TopicUser.Replies method to better abstract the reply list generation logic. Shortened some common.s to c.s Moved memStuff out of the analytics memory panes and into analytics.js Removed the temporary preStats fix for label overflow now that we have a better solution. Added the panel_analytics_script_memory template to help de-dupe logic in the analytics memory panes. Added the Topic method to TopicsRow. Added the GetRidsForTopic method to help cache replies in a small set of scenarios. Added the ReplyCache config.json setting. Added the ReplyCacheCapacity config.json setting. Added a parser test case. Added more Reply and ReplyStore related test cases.
2019-05-17 08:40:41 +00:00
ReplyCacheCapacity - The maximum number of replies you want in the in-memory reply cache, if enabled in the ReplyCache setting.
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
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.
Optimise the database layer. Refactor database adapters. Experimental last ip cutoff. More parser test cases.
2019-12-31 21:57:54 +00:00
LastIPCutoff - The number of months which need to pass before the last IP stored for a user is automatically deleted. Capped at 12. 0 defaults to whatever the current default is, currently 3 and -1 disables this feature.
The login and registration logs are pruned after a year now. Add filter exclusions for the user agents analytics pane. Shorten some of the variable names in qgen. Add ComplexDelete to the query adapter. Add DateCutoff and DateOlderThan to accDeleteBuilder.
2019-06-05 04:57:10 +00:00
Add Config.LogDir and Config.DisableSuspLog settings. Reduce default Config.PostIPCutoff from 120 to 90. Add another startup log call.
2021-03-24 08:08:37 +00:00
PostIPCutoff - The number of days which need to pass before the IP data for a post is automatically deleted. 0 defaults to whatever the current default is, currently 90 and -1 disables this feature.
Optimise the database layer. Refactor database adapters. Experimental last ip cutoff. More parser test cases.
2019-12-31 21:57:54 +00:00
more attachment tests Add UpdateLinked method to AttachmentStore.
2020-02-19 10:32:26 +00:00
PollIPCutoff - The number of days which need to pass before the IP data for a poll is automatically deleted. 0 defaults to whatever the current default is, currently 90 and -1 disables this feature.
Add PollIPCutoff configuration setting. Add tests for qgen processWhere and qgen mysql buildWhere. Shorten some things.
2020-01-02 05:28:36 +00:00
Add DisableLastIP configuration setting. Reduce default PollIPCutoff to 365.
2020-01-02 06:04:10 +00:00
DisableLastIP - Disable storing last IPs for users and purge any existing user last IP data. Default: false
Add DisablePostIP configuration setting.
2020-01-02 21:52:41 +00:00
DisablePostIP - Disable storing post IPs for users and purge any existing post IP data. Default: false
Add DisablePollIP configuration setting.
2020-01-02 09:49:34 +00:00
DisablePollIP - Disable storing poll vote IPs and purge any existing poll vote IP data. Default: false
Add PollIPCutoff configuration setting. Add tests for qgen processWhere and qgen mysql buildWhere. Shorten some things.
2020-01-02 05:28:36 +00:00
LogPruneCutoff - The number of days which need to pass before the login and registration logs are pruned. 0 defaults to whatever the current default is, currently 180 and -1 disables this feature.
Implemented periodic post IP purging for replies. Update for MySQL now supports DateCutoff and DateOlderThan. Added the DateOlderThan method to accUpdateBuilder. Added the PostIPCutoff config setting.
2019-05-08 09:50:10 +00:00
Added more default values to configuration.md
2019-04-14 23:39:13 +00:00
DisableLiveTopicList - This switch allows you to disable the live topic list. Default: false
Added information about the Email, DisableLiveTopicList, DisableJSAntispam, MaxTopicTitleLength and MaxUsernameLength configuration settings to configuration.md
2019-02-21 06:52:32 +00:00
Added more default values to configuration.md
2019-04-14 23:39:13 +00:00
DisableJSAntispam - This switch lets you disable the JS anti-spam feature. It may be useful if you primarily get users who for one reason or another have decided to disable JavaScript. Default: false
Added information about the Email, DisableLiveTopicList, DisableJSAntispam, MaxTopicTitleLength and MaxUsernameLength configuration settings to configuration.md
2019-02-21 06:52:32 +00:00
Update LooseHost / LoosePort notes.
2019-10-30 21:00:48 +00:00
LooseHost - Disable host header checks in the router. This may be useful when using a reverse-proxy like Nginx / Apache to stop it white-screening. Default: false
Added the LooseHost config setting. Malformed requests are now logged with an integer denoting the block of code which triggered it.
2019-04-14 00:13:32 +00:00
SslSchema notes.
2019-11-04 12:24:01 +00:00
LoosePort - Disable port match checks in the router. This may be useful when using a reverse-proxy like Nginx / Apache to stop it white-screening. Default: false
SslSchema - Allow for HTTPS URLs without necessarily using a HTTPS listener. This might be useful if a reverse-proxy or otherwise terminates the SSL / TLS connection instead of Gosora. Default: false
Added the LoosePort config.json setting.
2019-04-14 00:28:42 +00:00
Added more default values to configuration.md
2019-04-14 23:39:13 +00:00
DisableServerPush - This switch lets you disable the HTTP/2 server push feature. Default: false
Server push is back. But only for Chrome and Firefox. Added the DisableServerPush and EnableCDNPush config.json settings.
2019-04-02 07:43:11 +00:00
EnableCDNPush - This switch lets you enable the HTTP/2 CDN Server Push feature. This operates by sending a Link header on every request and may also work with reverse-proxies like Nginx for doing HTTP/2 server pushes.
The rest of the Control Panel (exc. the Group Editor) now uses dyntmpl. Improved the noavatar cacheability by constraining them in a range. Improved the noavatar cacheability by serving a small subset from Gosora. Improved the formatting of bytes in the memory analytics pane. Static resources with checksums will now have their caches expire in a week rather than a day. Tweaked the padding on the sub_heads on Nox. Moved a block of CSS out of a template and into panel.css in Tempra Simple and Shadow. Added the panel_themes_menus_items_suffix phrase. Added the DisableNoavatarRange config setting. Added the DisableDefaultNoavatar config setting.
2019-05-03 08:34:18 +00:00
DisableNoavatarRange - This switch lets you disable the noavatar algorithm which maps IDs to a set ranging from 0 to 50 for better cacheability. Default: false
DisableDefaultNoavatar - This switch lets you disable the default noavatar algorithm which may intercept noavatars for increased efficiency. Default: false
track favicon stats experiment with tracking average route performance temporary error route stub optimise dumprequest add DisableAnalytics config setting fix double hyphens in slugs being mistaken for sql injection more querygen tests You wil need to run the updater / patcher for this commit.
2020-02-26 10:34:38 +00:00
DisableAnalytics - This switch lets you disable the analytics subsystem. Default: false
More conversations work. Add support for AS in columns for SimpleInnerJoin. Add a referrer policy to improve privacy a little. Shorten /static/ to /s/ since it comes up so much. Remove some obsolete code. Shorten some variable names. Reduce the amount of boilerplate in the patcher. Added the RefNoTrack and RefNoRef privacy config settings. You may need to run the updater / patcher for this commit.
2019-08-14 10:39:04 +00:00
RefNoTrack - This switch disables tracking the referrers of users who click from another site to your site and the referrers of any requests to resources from other sites as-well.
RefNoRef - This switch makes it so that if a user clicks on a link, then the incoming site won't know which site they're coming from.
Config.NoEmbed should override user preferences.
2020-06-29 11:40:52 +00:00
NoEmbed - Don't expand links into videos or images. Default: false
NoEmbeds privacy and config settings. Phase out url_prefix and url_name. Eliminate some boilerplate and allocations while we're at it. Reduce the number of conditional statements in url validator loops. Better parsing of Site.URL to handle user error better. You will have to run the patcher / updater for this commit.
2019-12-08 03:40:56 +00:00
wip allow for more cdns add res template function add ExtraCSPOrigins config setting add StaticResBase config setting skip flush directives
2020-07-30 08:10:29 +00:00
ExtraCSPOrigins - Extra origins which may want whitelisted in the default Content Security Policy.
StaticResBase - The default prefix for static resource files. May be a path or an external domain like a CDN domain. Default: /s/
cover avatars with AvatarResBase config setting
2020-07-31 12:45:20 +00:00
AvatarResBase - The default prefix for avatar files. May be a path or an external domain like a CDN domain. Default: /uploads/
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
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.
Added information about the Email, DisableLiveTopicList, DisableJSAntispam, MaxTopicTitleLength and MaxUsernameLength configuration settings to configuration.md
2019-02-21 06:52:32 +00:00
MaxTopicTitleLength - The maximum length that a topic can be. Please note that this measures the number of bytes and may differ from language to language with it being equal to a letter in English and being two bytes in others.
MaxUsernameLength - The maximum length that a user's name can be. Please note that this measures the number of bytes and may differ from language to language with it being equal to a letter in English and being two bytes in others.
Experimenting with Nox's Control Panel. Experimenting with better cache busting for static resources. HTTPSRedirect requests are now counted in the route analytics. More scripts are loaded asynchronously now. Upped the default ReadTimeout to eight seconds. Reduce the number of unneccesary NewAcc calls. Added panel_before_head as an injection point for themes. Themes can now declare scripts to be loaded asynchronously. Tweaked the WS resumption algorithm to mae the backoffs a little less aggressive. Fixed an ordering issue in the WS resumption algorithm where backoffs weren't expiring as fast as they should have. Fixed a bug where template logs weren't being written due to a panic. You can now use byte slices in more places in the transpiled templates. Fixed a bug where Cosora's misc.js seemed to be erroring out. Fixed a bug where YT embeds were getting blocked by the CSP. Added the panel_back_to_site phrase. Added the panel_welcome phrase.
2019-03-21 22:59:41 +00:00
ReadTimeout - The number of seconds that we are allowed to take to fully read a request. Defaults to 8.
Added documentation for server timeouts. You can now disable server timeouts o.O Added a slightly more sophisticated WS Backoff algorithm.
2019-03-16 23:14:47 +00:00
WriteTimeout - The number of seconds that a route is allowed to run for before the request is automatically terminated. Defaults to 10.
IdleTimeout - The number of seconds that a Keep-Alive connection will be kept open before being closed. You might to tweak this, if you use Cloudflare or similar. Defaults to 120.
revert Config.LogDir for ops log rotate other req dump logs don't create the suspicious reqs log file when it is disabled
2021-03-24 10:50:22 +00:00
LogDir - The directory in which logs are stored, with the exception of ops log, until a related bug is resolved. Default: ./logs/
Add Config.LogDir and Config.DisableSuspLog settings. Reduce default Config.PostIPCutoff from 120 to 90. Add another startup log call.
2021-03-24 08:08:37 +00:00
DisableSuspLog - Whether suspicious requests are logged in the suspicious request logs. Enabling this may make a site faster. Defaults to false.
Added documentation for server timeouts. You can now disable server timeouts o.O Added a slightly more sophisticated WS Backoff algorithm.
2019-03-16 23:14:47 +00:00
Related: https://support.cloudflare.com/hc/en-us/articles/212794707-General-Best-Practices-for-Load-Balancing-at-your-origin-with-Cloudflare
Added information about the Email, DisableLiveTopicList, DisableJSAntispam, MaxTopicTitleLength and MaxUsernameLength configuration settings to configuration.md
2019-02-21 06:52:32 +00:00
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
# 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.
Added documentation for server timeouts. You can now disable server timeouts o.O Added a slightly more sophisticated WS Backoff algorithm.
2019-03-16 23:14:47 +00:00
TemplateDebug - Output a detailed level of information about what Gosora is doing during the template transpilation step. Warning: Large amounts of information will be dumped into the logs.
Added the configuration documentation file.
2019-02-20 05:35:18 +00:00
NoFsnotify - Whether you want to disable the file watcher which automatically reloads assets whenever they change.