Settings#
❗Since many settings can only be applied preflight by the app, it is strongly recommended to restart the app after changing the settings, so the changes will be applied.
App#
Settings related to the app.
Sever Ports#
The app provides two servers, one for the HTTP and one for HTTPS. Both servers CANNOT use the same port.
When a valid certificate is set up, disco will all requests to the HTTP server redirect to the HTTPS server. Requests from localhost and IPs or DNS hostnames listed in Allowed Clients for HTTP-API will not be redirected.
HTTP Port#
The HTTPs port the server will listen on, default is 3000.
HTTPS Port#
The HTTPs port the server will listen on, default is 3443.
Window#
Settings related to application window.
Show Window Frame#
Depending on this option the application window will be rendered with or without a window frame, default is true.
❗ This option will not have an effect when the window ist in Kiosk Mode or Fullscreen Mode. in this case the app window will always be rendered without a frame.
Logs#
Level#
Choose the log level. The options are debug, info, warn and error, default is info.
File#
If file logs are enabled, disco will write a log file to the selected Path. The file name is disco.log. Every day or every App-restart the Log file will be rotated. The naming scheme for the rotated files is disco_<index>.log.
enabled#
This option enables or disables file logs, default is false.
Path#
The path for the directory the log files will be written to.
The default depends on the host OS:
- Linux:
/home/<USER>/.config/disco/logs - macOS:
/Users/<USER>/Library/Application\ Support/disco/logs - Windows:
%APPDATA%\disco\logs
Max Files#
The maximal count of rotated log files until overwriting them, default is 10.
Syslog#
If syslog logs are enabled, disco will try to write logs via UDP to an external Syslog server.
enabled#
This option enables or disables syslog logs, default is false.
IP Address#
IPv4 address of the Syslog server , default is 127.0.0.1.
UDP Port#
The port the external Syslog server listens to, default is 514.
Facility#
The used Syslog facility, default is 16.
Newline#
With this option enabled, a newline character (\n) is added at the end of each log message, default is true.
Public Assets#
The app can serve a directory on reachable from the host. It's intended for assets like images or similar.
enabled#
This option enables or disables the Public Assets Server, default is false.
Path#
The path for the directory the log public assets will be served from.
The default depends on the host OS:
- Linux:
/home/<USER>/.config/disco/public - macOS:
/Users/<USER>/Library/Application\ Support/disco/public - Windows:
%APPDATA%\disco\public
HTTP API Proxy#
The intended way to use the API is HTTPS, but not all systems and devices are limited to HTTP. To integrate with such a system or device, disco provides a HTTP proxy.
Allowed Clients for HTTP-API#
Add IPs or a DNS hostnames from your LAN which not will be redirected to HTTPS when requesting the HTTP port. Requests from localhost will always be proxied.
Infos#
Settings related to infos screen.
Website#
Settings related to WebUI.
Font Size#
The font size of the widget. You can select between inherit, or enter a size in pixels. When inherit is selected, the Font Size will be taken from the app.
Infos Interval#
The interval the WebUI will poll the /infos API endpoint in seconds, default is 20.
Timezone#
When selected source is Datetime you can configure the timezone for the datetime string. The Options are based on the IANA Time Zone Database so you have to select a Region and a City to get the corresponding timezone. Default is Europe and Berlin.