shuo-docs/Configuration.md

54 lines
1.3 KiB
Markdown

This part of the documentation will focus on the configuration of your Shuo server. Start by locating the `config.js` file in the Shuo folder.
To quickly open the config:
```console
$ shuo config
```
## public
This setting can be either `true` or `false`. Public servers require no authentication. This is the default mode. Set to `false` to enable user login.
## host
Listen to connections only from this host. Default `0.0.0.0` will allow connections from anyone.
## port
The port to listen on.
You can override this setting by starting Shuo like this:
```console
$ shuo start --port 80
```
## theme
This setting should point to a stylesheet in your Shuo folder. If you want to create your own theme, it's recommended that you add your own stylesheet to `shout/client/themes/`.
## home
Use this setting to override the default `HOME` location. The home folder is where Shuo will locate the `users/` and `cache/` folder. Leaving this field empty will default to `~/.shout/`.
## logs
Change how the logs will be stored. Remember that logging has to be turned on per user, in their own `user.json`.
- format
- timezone
## defaults
These are the placeholder values displayed in the __Connect__ form:
- name
- host
- port
- password
- tls
- nick
- realname
- join