updated readme
This commit is contained in:
parent
c07e204b97
commit
c476d4b9f5
129
configuration.md
129
configuration.md
|
@ -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`)
|
||||||
|
|
Loading…
Reference in New Issue