updated readme

This commit is contained in:
Graham Steffaniak 2023-10-10 09:50:37 -05:00
parent c07e204b97
commit c476d4b9f5
1 changed files with 66 additions and 63 deletions

View File

@ -7,6 +7,9 @@ This document covers the available configuration options, their defaults, and ho
Here is an expanded config file which includes all possible configurations: Here is an expanded config file which includes all possible configurations:
``` ```
signup: false
adminUsername: admin
adminPassword: admin
server: server:
indexingInterval: 5 indexingInterval: 5
numImageProcessors: 4 numImageProcessors: 4
@ -30,20 +33,18 @@ auth:
header: "" header: ""
method: json method: json
command: "" command: ""
signup: false
shell: "" shell: ""
frontend: frontend:
name: "" name: ""
disableExternal: false disableExternal: false
disableUsedPercentage: true disableUsedPercentage: true
files: "" files: ""
theme: ""
color: "" color: ""
userDefaults: userDefaults:
settingsAllowed: true settingsAllowed: true
darkMode: false darkMode: false
scope: "" scope: ""
locale: "" locale: "en"
viewMode: "" viewMode: ""
singleClick: true singleClick: true
sorting: sorting:
@ -66,34 +67,38 @@ userDefaults:
Here are the defaults if nothing is set: Here are the defaults if nothing is set:
``` ```
Signup: true signup: true
AdminUsername: admin adminUsername: admin
AdminPassword: admin adminPassword: admin
Server: server:
EnableThumbnails: true enableThumbnails: true
EnableExec: false enableExec: false
IndexingInterval: 5 indexingInterval: 5
Port: 8080 port: 8080
NumImageProcessors: 4 numImageProcessors: 4
BaseURL: "" baseURL: ""
Database: database.db database: database.db
Log: stdout log: stdout
Root: /srv root: /srv
Auth: auth:
Method: password method: password
Recaptcha: recaptcha:
Host: "" host: ""
UserDefaults: userDefaults:
Scope: "." settingsAllowed: true
LockPassword: false darkMode: false
HideDotfiles: true scope: ""
Permissions: locale: "en"
Create: true scope: "."
Rename: true lockPassword: false
Modify: true hideDotfiles: true
Delete: true permissions:
Share: true create: true
Download: true rename: true
modify: true
delete: true
share: true
download: true
``` ```
## About each configuration ## About each configuration
@ -102,17 +107,17 @@ UserDefaults:
## About each configuration ## About each configuration
- `Signup`: This boolean value indicates whether user signup is enabled. - `Signup`: This boolean value indicates whether user signup is enabled on the login page. NOTE: Be mindful of `userDefaults` settings if enabled. Default: `false`
- `AdminUsername`: This is the username of the admin user. - `AdminUsername`: This is the username of the admin user. Default: `admin`
- `AdminPassword`: This is the password of the admin user. - `AdminPassword`: This is the password of the admin user. Default: `admin`
### Server configuration settings ### Server configuration settings
- `indexingInterval`: This is the time in minutes the system waits before checking for filesystem changes (used in search only). - `indexingInterval`: This is the time in minutes the system waits before checking for filesystem changes. Default: `5`
- `numImageProcessors`: This is the number of image processors available. - `numImageProcessors`: This is the number of image processors available. Default: `4`
- `socket`: This is the socket configuration. - `socket`: This is the socket configuration.
@ -120,23 +125,23 @@ UserDefaults:
- `tlsCert`: This is the TLS certificate configuration. - `tlsCert`: This is the TLS certificate configuration.
- `enableThumbnails`: This boolean value determines whether thumbnails are enabled. - `enableThumbnails`: This boolean value determines whether thumbnails are enabled on ui. Default: `true`
- `resizePreview`: This boolean value determines whether preview resizing is enabled. - `resizePreview`: This boolean value determines whether preview resizing is enabled. Default: `false`
- `typeDetectionByHeader`: This boolean value determines whether type detection is based on headers. - `typeDetectionByHeader`: This boolean value determines whether type detection is based on headers.
- `port`: This is the port number on which the server is running. - `port`: This is the port number on which the server is running. Default: `8080`
- `baseURL`: This is the base URL for the server. - `baseURL`: This is the base URL for the server. Default: `""`
- `address`: This is the server address configuration. - `address`: This is the server address configuration. Default: `0.0.0.0`
- `log`: This specifies the log destination (e.g., "stdout" for standard output). - `log`: This specifies the log destination. Default: `stdout`
- `database`: This is the database file path + filename that will be created if it does not already exist. If it exists, it will use the existing file. - `database`: This is the database file path + filename that will be created if it does not already exist. If it exists, it will use the existing file. Default `database.db`
- `root`: This is the root directory path. - `root`: This is the root directory path. Default: `/srv`
### Auth configuration settings ### Auth configuration settings
@ -151,17 +156,16 @@ UserDefaults:
- `header`: This is the authentication header. - `header`: This is the authentication header.
- `method`: This is the authentication method used (e.g., "json"). Possible values: - `method`: This is the authentication method used (e.g., "json"). Possible values:
- password - username and password - `password` - username and password
- hook - hook authentication - `hook` - hook authentication
- proxy - proxy authentication - `proxy` - proxy authentication
- oath - oath authentication - `oath` - oath authentication
- `noauth` - no authentication/login required.
- `command`: This is the authentication command. - `command`: Deprecated: This is the authentication command.
- `signup`: This boolean value indicates whether user signup is enabled.
- `shell`: This is the shell configuration. - `shell`: This is the shell configuration.
### Frontend configuration settings ### Frontend configuration settings
- `name`: This is the name of the frontend. - `name`: This is the name of the frontend.
@ -175,26 +179,26 @@ UserDefaults:
- `theme`: This is the theme configuration. - `theme`: This is the theme configuration.
- `color`: This is the color configuration. - `color`: This is the color configuration.
### UserDefaults configuration settings ### UserDefaults configuration settings
- `darkMode`: Determines whether dark mode is enabled for the user (true or false) - `darkMode`: Determines whether dark mode is enabled for the user (`true` or `false`)
- `settingsAllowed`: Determines whether settings page is enabled for the user (true or false) - `settingsAllowed`: Determines whether settings page is enabled for the user (`true` or `false`)
- `scope`: This is a scope of the permissions, "." or "./" means all directories, "./downloads" would mean only the downloads folder. - `scope`: This is a scope of the permissions, "." or "./" means all directories, "./downloads" would mean only the downloads folder.
- `locale`: This is the locale configuration. - `locale`: String locale configuration. Default: `en`
- `viewMode`: This is the view mode configuration. - `viewMode`: This is the view mode configuration. Possible values: `normal`, `compact`, `list`, and `gallery`. default: `normal`
- `singleClick`: This boolean value determines whether single-click is enabled. - `singleClick`: This boolean value determines whether single-click is enabled. (`true` or `false`)
- `sorting`: - `sorting`:
- `by`: This is the sorting method used (e.g., "asc"). - `by`: This is the sorting method used (e.g., "asc").
- `asc`: This boolean value determines the sorting order. - `asc`: This boolean value determines the sorting order is ascending or descending. (`true` or `false`)
- `permissions`: - `permissions`:
@ -214,9 +218,8 @@ UserDefaults:
- `download`: This boolean value determines whether download permissions are granted. - `download`: This boolean value determines whether download permissions are granted.
- `commands`: This is a list of commands. - `commands`: Deprecated: This is a list of commands.
- `hideDotfiles`: This boolean value determines whether dotfiles are hidden. - `hideDotfiles`: This boolean value determines whether dotfiles are hidden. (`true` or `false`)
- `dateFormat`: This boolean value determines whether date formatting is enabled.
- `dateFormat`: This boolean value determines whether date formatting is enabled. (`true` or `false`)