52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
# special-applications
|
|
|
|
You can add more application sections into applications-tree.json.
|
|
You have to specify the application name and version. For example:
|
|
|
|
{
|
|
"name": "nextcloud",
|
|
"version": "latest"
|
|
}
|
|
|
|
The name must be the same as the directory name of the application.
|
|
|
|
The directory of an application have to contain a template.json file and can contain more json files (service, domain, secret, etc. files).
|
|
|
|
The mandatory template.json file's structure is the following.
|
|
- "name" - the name of the application, must be the same as the directory name
|
|
- "fields" - array of used variables by service
|
|
|
|
{
|
|
"name": "vaultwarden",
|
|
"fields": [
|
|
...
|
|
]
|
|
}
|
|
|
|
An element of fields can contain the following keys.
|
|
- description - label of the field, this text will appear before element
|
|
- key - name of variable
|
|
- value - default value of variable in the form
|
|
- required - if set "true" then fill in of the field is required in the form
|
|
- type - if not set then default is text, available field types: text, password, textarea, select
|
|
- if type is "select" then options are separated by ",". Option's value and text is separated by ":", but text is not mandatory. For example:
|
|
|
|
"value": "yes,no"
|
|
"value": "1:gmail,2:microsoft outlook/hotmail,3:other",
|
|
|
|
- generated - the value of the variable is auto generated, so the field will not appear in the form. Generated examples:
|
|
|
|
"time|md5|8" - generated from time, encoded by md5 and character length is 8
|
|
"random|md5|20" - random generated number, encoded by sha256, length is 20
|
|
|
|
Field element example:
|
|
|
|
{
|
|
"description": "Please add Nextcloud password:",
|
|
"key": "NEXTCLOUD_PASSWORD",
|
|
"value": "",
|
|
"required": "true",
|
|
"type": "password"
|
|
},
|
|
|