mirror of
https://git.pleroma.social/pleroma/pleroma.git
synced 2024-12-23 00:26:30 +00:00
docs and descriptions for s3 settings
This commit is contained in:
parent
4301ae3861
commit
b1b8f5f11a
2 changed files with 50 additions and 7 deletions
|
@ -2579,8 +2579,7 @@ config :pleroma, :config_description, [
|
||||||
%{
|
%{
|
||||||
key: :enabled,
|
key: :enabled,
|
||||||
type: :boolean,
|
type: :boolean,
|
||||||
description: "Enables new users admin digest email when `true`",
|
description: "Enables new users admin digest email when `true`"
|
||||||
suggestions: [false]
|
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
@ -3444,8 +3443,7 @@ config :pleroma, :config_description, [
|
||||||
key: :strict,
|
key: :strict,
|
||||||
type: :boolean,
|
type: :boolean,
|
||||||
description:
|
description:
|
||||||
"Enables strict input validation (useful in development, not recommended in production)",
|
"Enables strict input validation (useful in development, not recommended in production)"
|
||||||
suggestions: [false]
|
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
@ -3461,5 +3459,31 @@ config :pleroma, :config_description, [
|
||||||
description: "Allow/disallow displaying and getting instances favicons"
|
description: "Allow/disallow displaying and getting instances favicons"
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
|
},
|
||||||
|
%{
|
||||||
|
group: :ex_aws,
|
||||||
|
key: :s3,
|
||||||
|
type: :group,
|
||||||
|
descriptions: "S3 service related settings",
|
||||||
|
children: [
|
||||||
|
%{
|
||||||
|
key: :access_key_id,
|
||||||
|
type: :string,
|
||||||
|
description: "S3 access key ID",
|
||||||
|
suggestions: ["AKIAQ8UKHTGIYN7DMWWJ"]
|
||||||
|
},
|
||||||
|
%{
|
||||||
|
key: :secret_access_key,
|
||||||
|
type: :string,
|
||||||
|
description: "Secret access key",
|
||||||
|
suggestions: ["JFGt+fgH1UQ7vLUQjpW+WvjTdV/UNzVxcwn7DkaeFKtBS5LvoXvIiME4NQBsT6ZZ"]
|
||||||
|
},
|
||||||
|
%{
|
||||||
|
key: :host,
|
||||||
|
type: :string,
|
||||||
|
description: "S3 host",
|
||||||
|
suggestions: ["s3.eu-central-1.amazonaws.com"]
|
||||||
|
}
|
||||||
|
]
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
|
|
|
@ -476,7 +476,6 @@ For each pool, the options are:
|
||||||
* `:timeout` - timeout while `gun` will wait for response
|
* `:timeout` - timeout while `gun` will wait for response
|
||||||
* `:max_overflow` - additional workers if pool is under load
|
* `:max_overflow` - additional workers if pool is under load
|
||||||
|
|
||||||
|
|
||||||
## Captcha
|
## Captcha
|
||||||
|
|
||||||
### Pleroma.Captcha
|
### Pleroma.Captcha
|
||||||
|
@ -494,7 +493,7 @@ A built-in captcha provider. Enabled by default.
|
||||||
#### Pleroma.Captcha.Kocaptcha
|
#### Pleroma.Captcha.Kocaptcha
|
||||||
|
|
||||||
Kocaptcha is a very simple captcha service with a single API endpoint,
|
Kocaptcha is a very simple captcha service with a single API endpoint,
|
||||||
the source code is here: https://github.com/koto-bank/kocaptcha. The default endpoint
|
the source code is here: [kocaptcha](https://github.com/koto-bank/kocaptcha). The default endpoint
|
||||||
`https://captcha.kotobank.ch` is hosted by the developer.
|
`https://captcha.kotobank.ch` is hosted by the developer.
|
||||||
|
|
||||||
* `endpoint`: the Kocaptcha endpoint to use.
|
* `endpoint`: the Kocaptcha endpoint to use.
|
||||||
|
@ -502,6 +501,7 @@ the source code is here: https://github.com/koto-bank/kocaptcha. The default end
|
||||||
## Uploads
|
## Uploads
|
||||||
|
|
||||||
### Pleroma.Upload
|
### Pleroma.Upload
|
||||||
|
|
||||||
* `uploader`: Which one of the [uploaders](#uploaders) to use.
|
* `uploader`: Which one of the [uploaders](#uploaders) to use.
|
||||||
* `filters`: List of [upload filters](#upload-filters) to use.
|
* `filters`: List of [upload filters](#upload-filters) to use.
|
||||||
* `link_name`: When enabled Pleroma will add a `name` parameter to the url of the upload, for example `https://instance.tld/media/corndog.png?name=corndog.png`. This is needed to provide the correct filename in Content-Disposition headers when using filters like `Pleroma.Upload.Filter.Dedupe`
|
* `link_name`: When enabled Pleroma will add a `name` parameter to the url of the upload, for example `https://instance.tld/media/corndog.png?name=corndog.png`. This is needed to provide the correct filename in Content-Disposition headers when using filters like `Pleroma.Upload.Filter.Dedupe`
|
||||||
|
@ -514,10 +514,15 @@ the source code is here: https://github.com/koto-bank/kocaptcha. The default end
|
||||||
`strip_exif` has been replaced by `Pleroma.Upload.Filter.Mogrify`.
|
`strip_exif` has been replaced by `Pleroma.Upload.Filter.Mogrify`.
|
||||||
|
|
||||||
### Uploaders
|
### Uploaders
|
||||||
|
|
||||||
#### Pleroma.Uploaders.Local
|
#### Pleroma.Uploaders.Local
|
||||||
|
|
||||||
* `uploads`: Which directory to store the user-uploads in, relative to pleroma’s working directory.
|
* `uploads`: Which directory to store the user-uploads in, relative to pleroma’s working directory.
|
||||||
|
|
||||||
#### Pleroma.Uploaders.S3
|
#### Pleroma.Uploaders.S3
|
||||||
|
|
||||||
|
Don't forget to configure [Ex AWS S3](#ex-aws-s3-settings)
|
||||||
|
|
||||||
* `bucket`: S3 bucket name.
|
* `bucket`: S3 bucket name.
|
||||||
* `bucket_namespace`: S3 bucket namespace.
|
* `bucket_namespace`: S3 bucket namespace.
|
||||||
* `public_endpoint`: S3 endpoint that the user finally accesses(ex. "https://s3.dualstack.ap-northeast-1.amazonaws.com")
|
* `public_endpoint`: S3 endpoint that the user finally accesses(ex. "https://s3.dualstack.ap-northeast-1.amazonaws.com")
|
||||||
|
@ -526,6 +531,20 @@ For example, when using CDN to S3 virtual host format, set "".
|
||||||
At this time, write CNAME to CDN in public_endpoint.
|
At this time, write CNAME to CDN in public_endpoint.
|
||||||
* `streaming_enabled`: Enable streaming uploads, when enabled the file will be sent to the server in chunks as it's being read. This may be unsupported by some providers, try disabling this if you have upload problems.
|
* `streaming_enabled`: Enable streaming uploads, when enabled the file will be sent to the server in chunks as it's being read. This may be unsupported by some providers, try disabling this if you have upload problems.
|
||||||
|
|
||||||
|
#### Ex AWS S3 settings
|
||||||
|
|
||||||
|
* `access_key_id`: Access key ID
|
||||||
|
* `secret_access_key`: Secret access key
|
||||||
|
* `host`: S3 host
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```elixir
|
||||||
|
config :ex_aws, :s3,
|
||||||
|
access_key_id: "xxxxxxxxxx",
|
||||||
|
secret_access_key: "yyyyyyyyyy",
|
||||||
|
host: "s3.eu-central-1.amazonaws.com"
|
||||||
|
```
|
||||||
|
|
||||||
### Upload filters
|
### Upload filters
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue