6 {Phoenix.Socket.V1.JSONSerializer, "~> 1.0.0"},
7 {Phoenix.Socket.V2.JSONSerializer, "~> 2.0.0"}
14 installed_frontend_options = [
20 "Name of the installed frontend. Valid config must include both `Name` and `Reference` values."
27 "Reference of the installed frontend to be used. Valid config must include both `Name` and `Reference` values."
36 description: "Name of the frontend."
42 description: "Reference of the frontend to be used."
46 label: "Git Repository URL",
48 description: "URL of the git repository of the frontend"
55 "Either an url to a zip file containing the frontend or a template to build it by inserting the `ref`. The string `${ref}` will be replaced by the configured `ref`.",
56 example: "https://some.url/builds/${ref}.zip"
60 label: "Build directory",
62 description: "The directory inside the zip file "
66 config :pleroma, :config_description, [
71 description: "Upload general settings",
76 description: "Module which will be used for uploads",
77 suggestions: {:list_behaviour_implementations, Pleroma.Uploaders.Uploader}
81 type: {:list, :module},
83 "List of filter modules for uploads. Module names are shortened (removed leading `Pleroma.Upload.Filter.` part), but on adding custom module you need to use full name.",
84 suggestions: {:list_behaviour_implementations, Pleroma.Upload.Filter}
90 "If enabled, a name parameter will be added to the URL of the upload. For example `https://instance.tld/media/imagehash.png?name=realname.png`."
96 description: "Base URL for the uploads, needed if you use CDN",
98 "https://cdn-host.com"
105 "If enabled, requests to media stored using a remote uploader will be proxied instead of being redirected"
109 label: "Proxy Options",
111 description: "Options for Pleroma.ReverseProxy",
113 redirect_on_failure: false,
114 max_body_length: 25 * 1_048_576,
116 follow_redirect: true,
122 key: :redirect_on_failure,
125 "Redirects the client to the real remote URL if there's any HTTP errors. " <>
126 "Any error during body processing will not be redirected as the response is chunked."
129 key: :max_body_length,
132 "Limits the content length to be approximately the " <>
133 "specified length. It is validated with the `content-length` header and also verified when proxying."
139 description: "HTTP options",
144 description: "Adapter specific options",
149 label: "SSL Options",
150 description: "SSL options for HTTP adapter",
154 type: {:list, :atom},
155 description: "List of TLS versions to use",
156 suggestions: [:tlsv1, ":tlsv1.1", ":tlsv1.2"]
165 type: [:string, :tuple],
166 description: "Proxy URL",
167 suggestions: ["127.0.0.1:8123", {:socks5, :localhost, 9050}]
174 key: :filename_display_max_length,
176 description: "Set max length of a filename to display. 0 = no limit. Default: 30"
182 key: Pleroma.Uploaders.Local,
184 description: "Local uploader-related settings",
189 description: "Path where user's uploads will be saved",
198 key: Pleroma.Uploaders.S3,
200 description: "S3 uploader-related settings",
205 description: "S3 bucket",
211 key: :bucket_namespace,
213 description: "S3 bucket namespace",
214 suggestions: ["pleroma"]
217 key: :public_endpoint,
219 description: "S3 endpoint",
220 suggestions: ["https://s3.amazonaws.com"]
223 key: :truncated_namespace,
226 "If you use S3 compatible service such as Digital Ocean Spaces or CDN, set folder name or \"\" etc." <>
227 " For example, when using CDN to S3 virtual host format, set \"\". At this time, write CNAME to CDN in public_endpoint."
230 key: :streaming_enabled,
233 "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."
239 key: Pleroma.Upload.Filter.Mogrify,
241 description: "Uploads mogrify filter settings",
245 type: [:string, {:list, :string}, {:list, :tuple}],
247 "List of actions for the mogrify command. It's possible to add self-written settings as string. " <>
248 "For example `auto-orient, strip, {\"resize\", \"3840x1080>\"}` value will be parsed into valid list of the settings.",
259 key: Pleroma.Upload.Filter.AnonymizeFilename,
261 description: "Filter replaces the filename of the upload",
267 "Text to replace filenames in links. If no setting, {random}.extension will be used. You can get the original" <>
268 " filename extension by using {extension}, for example custom-file-name.{extension}.",
270 "custom-file-name.{extension}"
279 description: "Websocket based federation",
284 description: "Enable FedSockets"
290 key: Pleroma.Emails.Mailer,
292 description: "Mailer-related settings",
298 "One of the mail adapters listed in [Swoosh readme](https://github.com/swoosh/swoosh#adapters)," <>
299 " or Swoosh.Adapters.Local for in-memory mailbox",
301 Swoosh.Adapters.SMTP,
302 Swoosh.Adapters.Sendgrid,
303 Swoosh.Adapters.Sendmail,
304 Swoosh.Adapters.Mandrill,
305 Swoosh.Adapters.Mailgun,
306 Swoosh.Adapters.Mailjet,
307 Swoosh.Adapters.Postmark,
308 Swoosh.Adapters.SparkPost,
309 Swoosh.Adapters.AmazonSES,
311 Swoosh.Adapters.SocketLabs,
312 Swoosh.Adapters.Gmail,
313 Swoosh.Adapters.Local
319 description: "Allow/disallow send emails"
322 group: {:subgroup, Swoosh.Adapters.SMTP},
325 description: "`Swoosh.Adapters.SMTP` adapter specific setting",
326 suggestions: ["smtp.gmail.com"]
329 group: {:subgroup, Swoosh.Adapters.SMTP},
332 description: "`Swoosh.Adapters.SMTP` adapter specific setting",
333 suggestions: ["pleroma"]
336 group: {:subgroup, Swoosh.Adapters.SMTP},
339 description: "`Swoosh.Adapters.SMTP` adapter specific setting",
340 suggestions: ["password"]
343 group: {:subgroup, Swoosh.Adapters.SMTP},
347 description: "`Swoosh.Adapters.SMTP` adapter specific setting"
350 group: {:subgroup, Swoosh.Adapters.SMTP},
354 description: "`Swoosh.Adapters.SMTP` adapter specific setting",
355 suggestions: [:always, :never, :if_available]
358 group: {:subgroup, Swoosh.Adapters.SMTP},
361 description: "`Swoosh.Adapters.SMTP` adapter specific setting",
362 suggestions: [:always, :never, :if_available]
365 group: {:subgroup, Swoosh.Adapters.SMTP},
368 description: "`Swoosh.Adapters.SMTP` adapter specific setting",
372 group: {:subgroup, Swoosh.Adapters.SMTP},
375 description: "`Swoosh.Adapters.SMTP` adapter specific setting",
379 group: {:subgroup, Swoosh.Adapters.SMTP},
381 label: "No MX lookups",
383 description: "`Swoosh.Adapters.SMTP` adapter specific setting"
386 group: {:subgroup, Swoosh.Adapters.Sendgrid},
390 description: "`Swoosh.Adapters.Sendgrid` adapter specific setting",
391 suggestions: ["my-api-key"]
394 group: {:subgroup, Swoosh.Adapters.Sendmail},
397 description: "`Swoosh.Adapters.Sendmail` adapter specific setting",
398 suggestions: ["/usr/bin/sendmail"]
401 group: {:subgroup, Swoosh.Adapters.Sendmail},
404 description: "`Swoosh.Adapters.Sendmail` adapter specific setting",
405 suggestions: ["-N delay,failure,success"]
408 group: {:subgroup, Swoosh.Adapters.Sendmail},
411 description: "`Swoosh.Adapters.Sendmail` adapter specific setting"
414 group: {:subgroup, Swoosh.Adapters.Mandrill},
418 description: "`Swoosh.Adapters.Mandrill` adapter specific setting",
419 suggestions: ["my-api-key"]
422 group: {:subgroup, Swoosh.Adapters.Mailgun},
426 description: "`Swoosh.Adapters.Mailgun` adapter specific setting",
427 suggestions: ["my-api-key"]
430 group: {:subgroup, Swoosh.Adapters.Mailgun},
433 description: "`Swoosh.Adapters.Mailgun` adapter specific setting",
434 suggestions: ["pleroma.com"]
437 group: {:subgroup, Swoosh.Adapters.Mailjet},
441 description: "`Swoosh.Adapters.Mailjet` adapter specific setting",
442 suggestions: ["my-api-key"]
445 group: {:subgroup, Swoosh.Adapters.Mailjet},
448 description: "`Swoosh.Adapters.Mailjet` adapter specific setting",
449 suggestions: ["my-secret-key"]
452 group: {:subgroup, Swoosh.Adapters.Postmark},
456 description: "`Swoosh.Adapters.Postmark` adapter specific setting",
457 suggestions: ["my-api-key"]
460 group: {:subgroup, Swoosh.Adapters.SparkPost},
464 description: "`Swoosh.Adapters.SparkPost` adapter specific setting",
465 suggestions: ["my-api-key"]
468 group: {:subgroup, Swoosh.Adapters.SparkPost},
471 description: "`Swoosh.Adapters.SparkPost` adapter specific setting",
472 suggestions: ["https://api.sparkpost.com/api/v1"]
475 group: {:subgroup, Swoosh.Adapters.AmazonSES},
478 description: "`Swoosh.Adapters.AmazonSES` adapter specific setting",
479 suggestions: ["us-east-1", "us-east-2"]
482 group: {:subgroup, Swoosh.Adapters.AmazonSES},
485 description: "`Swoosh.Adapters.AmazonSES` adapter specific setting",
486 suggestions: ["aws-access-key"]
489 group: {:subgroup, Swoosh.Adapters.AmazonSES},
492 description: "`Swoosh.Adapters.AmazonSES` adapter specific setting",
493 suggestions: ["aws-secret-key"]
496 group: {:subgroup, Swoosh.Adapters.Dyn},
500 description: "`Swoosh.Adapters.Dyn` adapter specific setting",
501 suggestions: ["my-api-key"]
504 group: {:subgroup, Swoosh.Adapters.SocketLabs},
507 description: "`Swoosh.Adapters.SocketLabs` adapter specific setting"
510 group: {:subgroup, Swoosh.Adapters.SocketLabs},
514 description: "`Swoosh.Adapters.SocketLabs` adapter specific setting"
517 group: {:subgroup, Swoosh.Adapters.Gmail},
520 description: "`Swoosh.Adapters.Gmail` adapter specific setting"
527 description: "`Swoosh.Adapters.Local` adapter specific settings",
530 group: {:subgroup, Swoosh.Adapters.Local},
533 description: "Run the preview server together as part of your app"
536 group: {:subgroup, Swoosh.Adapters.Local},
539 description: "The preview server port",
547 label: "URI Schemes",
549 description: "URI schemes related settings",
553 type: {:list, :string},
554 description: "List of the scheme part that is considered valid to be an URL",
579 description: "Instance-related settings",
584 description: "Name of the instance",
591 label: "Admin Email Address",
593 description: "Email used to reach an Administrator/Moderator of the instance",
600 label: "Sender Email Address",
602 description: "Envelope FROM address for mail sent via Pleroma",
611 "The instance's description. It can be seen in nodeinfo and `/api/v1/instance`",
619 description: "Posts character limit (CW/Subject included in the counter)",
627 description: "Character limit of the instance chat messages",
635 description: "Hard character limit beyond which remote posts will be dropped",
643 description: "File size limit of uploads (except for avatar, background, banner)",
649 key: :avatar_upload_limit,
651 description: "File size limit of user's profile avatars",
657 key: :background_upload_limit,
659 description: "File size limit of user's profile backgrounds",
665 key: :banner_upload_limit,
667 description: "File size limit of user's profile banners",
675 description: "A map with poll limits for local polls",
679 max_option_chars: 200,
681 max_expiration: 31_536_000
688 description: "Maximum number of options",
692 key: :max_option_chars,
694 description: "Maximum number of characters per option",
698 key: :min_expiration,
700 description: "Minimum expiration time (in seconds)",
704 key: :max_expiration,
706 description: "Maximum expiration time (in seconds)",
712 key: :registrations_open,
715 "Enable registrations for anyone. Invitations require this setting to be disabled."
718 key: :invites_enabled,
721 "Enable user invitations for admins (depends on `registrations_open` being disabled)"
724 key: :account_activation_required,
726 description: "Require users to confirm their emails before signing in"
729 key: :account_approval_required,
731 description: "Require users to be manually approved by an admin before signing in"
736 description: "Enable federation with other instances"
739 key: :federation_incoming_replies_max_depth,
740 label: "Fed. incoming replies max depth",
743 "Max. depth of reply-to and reply activities fetching on incoming federation, to prevent out-of-memory situations while" <>
744 " fetching very long threads. If set to `nil`, threads of any depth will be fetched. Lower this value if you experience out-of-memory crashes.",
750 key: :federation_reachability_timeout_days,
751 label: "Fed. reachability timeout days",
754 "Timeout (in days) of each external federation target being unreachable prior to pausing federating to it",
762 description: "Enable Pleroma's Relay, which makes it possible to follow a whole instance"
768 "Makes the client API in authenticated mode-only except for user-profiles." <>
769 " Useful for disabling the Local Timeline and The Whole Known Network. " <>
770 " Note: when setting to `false`, please also check `:restrict_unauthenticated` setting."
773 key: :quarantined_instances,
774 type: {:list, :string},
776 "List of ActivityPub instances where private (DMs, followers-only) activities will not be sent",
785 description: "Instance static directory",
791 key: :allowed_post_formats,
792 type: {:list, :string},
793 description: "MIME-type list of formats allowed to be posted (transformed into HTML)",
802 key: :extended_nickname_format,
805 "Enable to use extended local nicknames format (allows underscores/dashes)." <>
806 " This will break federation with older software for theses nicknames."
809 key: :cleanup_attachments,
812 Enable to remove associated attachments when status is removed.
813 This will not affect duplicates and attachments without status.
814 Enabling this will increase load to database when deleting statuses on larger instances.
818 key: :max_pinned_statuses,
820 description: "The maximum number of pinned statuses. 0 will disable the feature.",
828 key: :autofollowed_nicknames,
829 type: {:list, :string},
831 "Set to nicknames of (local) users that every new user should automatically follow"
834 key: :autofollowing_nicknames,
835 type: {:list, :string},
837 "Set to nicknames of (local) users that automatically follows every newly registered user"
840 key: :attachment_links,
842 description: "Enable to automatically add attachment link text to statuses"
845 key: :max_report_comment_size,
847 description: "The maximum size of the report comment. Default: 1000.",
853 key: :safe_dm_mentions,
854 label: "Safe DM mentions",
857 "If enabled, only mentions at the beginning of a post will be used to address people in direct messages." <>
858 " This is to prevent accidental mentioning of people when talking about them (e.g. \"@admin please keep an eye on @bad_actor\")." <>
864 description: "If enabled, system data will be shown on `/api/pleroma/healthcheck`"
867 key: :remote_post_retention_days,
870 "The default amount of days to retain remote posts when pruning the database",
876 key: :user_bio_length,
878 description: "A user bio maximum length. Default: 5000.",
884 key: :user_name_length,
886 description: "A user name maximum length. Default: 100.",
892 key: :skip_thread_containment,
894 description: "Skip filtering out broken threads. Default: enabled."
897 key: :limit_to_local_content,
898 type: {:dropdown, :atom},
900 "Limit unauthenticated users to search for local statutes and users only. Default: `:unauthenticated`.",
908 key: :max_account_fields,
910 description: "The maximum number of custom fields in the user profile. Default: 10.",
916 key: :max_remote_account_fields,
919 "The maximum number of custom fields in the remote user profile. Default: 20.",
925 key: :account_field_name_length,
927 description: "An account field name maximum length. Default: 512.",
933 key: :account_field_value_length,
935 description: "An account field value maximum length. Default: 2048.",
941 key: :registration_reason_length,
943 description: "Maximum registration reason length. Default: 500.",
949 key: :external_user_synchronization,
951 description: "Enabling following/followers counters synchronization for external users"
954 key: :multi_factor_authentication,
956 description: "Multi-factor authentication settings",
959 totp: [digits: 6, period: 30],
960 backup_codes: [number: 5, length: 16]
966 label: "TOTP settings",
968 description: "TOTP settings",
969 suggestions: [digits: 6, period: 30],
976 "Determines the length of a one-time pass-code, in characters. Defaults to 6 characters."
983 "A period for which the TOTP code will be valid, in seconds. Defaults to 30 seconds."
990 description: "MFA backup codes settings",
991 suggestions: [number: 5, length: 16],
997 description: "Number of backup codes to generate."
1004 "Determines the length of backup one-time pass-codes, in characters. Defaults to 16 characters."
1011 key: :instance_thumbnail,
1012 type: {:string, :image},
1014 "The instance thumbnail can be any image that represents your instance and is used by some apps or services when they display information about your instance.",
1015 suggestions: ["/instance/thumbnail.jpeg"]
1018 key: :show_reactions,
1020 description: "Let favourites and emoji reactions be viewed through the API."
1028 description: "Welcome messages settings",
1031 key: :direct_message,
1033 descpiption: "Direct message settings",
1038 description: "Enables sending a direct message to newly registered users"
1043 description: "A message that will be sent to newly registered users",
1045 "Hi, @username! Welcome on board!"
1049 key: :sender_nickname,
1051 description: "The nickname of the local user that sends a welcome message",
1061 descpiption: "Chat message settings",
1066 description: "Enables sending a chat message to newly registered users"
1072 "A message that will be sent to newly registered users as a chat message",
1074 "Hello, welcome on board!"
1078 key: :sender_nickname,
1080 description: "The nickname of the local user that sends a welcome chat message",
1090 descpiption: "Email message settings",
1095 description: "Enables sending an email to newly registered users"
1099 type: [:string, :tuple],
1101 "Email address and/or nickname that will be used to send the welcome email.",
1103 {"Pleroma App", "welcome@pleroma.app"}
1110 "Subject of the welcome email. EEX template with user and instance_name variables can be used.",
1111 suggestions: ["Welcome to <%= instance_name%>"]
1117 "HTML content of the welcome email. EEX template with user and instance_name variables can be used.",
1118 suggestions: ["<h1>Hello <%= user.name%>. Welcome to <%= instance_name%></h1>"]
1124 "Text content of the welcome email. EEX template with user and instance_name variables can be used.",
1125 suggestions: ["Hello <%= user.name%>. \n Welcome to <%= instance_name%>\n"]
1134 description: "Logger-related settings",
1138 type: [:atom, :tuple, :module],
1140 "Where logs will be sent, :console - send logs to stdout, { ExSyslogger, :ex_syslogger } - to syslog, Quack.Logger - to Slack.",
1141 suggestions: [:console, {ExSyslogger, :ex_syslogger}, Quack.Logger]
1149 label: "ExSyslogger",
1150 description: "ExSyslogger-related settings",
1154 type: {:dropdown, :atom},
1155 description: "Log level",
1156 suggestions: [:debug, :info, :warn, :error]
1162 "A string that's prepended to every message, and is typically set to the app name",
1163 suggestions: ["pleroma"]
1168 description: "Default: \"$date $time [$level] $levelpad$node $metadata $message\"",
1169 suggestions: ["$metadata[$level] $message"]
1173 type: {:list, :atom},
1174 suggestions: [:request_id]
1182 label: "Console Logger",
1183 description: "Console logger settings",
1187 type: {:dropdown, :atom},
1188 description: "Log level",
1189 suggestions: [:debug, :info, :warn, :error]
1194 description: "Default: \"$date $time [$level] $levelpad$node $metadata $message\"",
1195 suggestions: ["$metadata[$level] $message"]
1199 type: {:list, :atom},
1200 suggestions: [:request_id]
1207 label: "Quack Logger",
1208 description: "Quack-related settings",
1212 type: {:dropdown, :atom},
1213 description: "Log level",
1214 suggestions: [:debug, :info, :warn, :error]
1218 type: {:list, :atom},
1219 description: "Configure which metadata you want to report on",
1236 label: "Webhook URL",
1238 description: "Configure the Slack incoming webhook",
1239 suggestions: ["https://hooks.slack.com/services/YOUR-KEY-HERE"]
1245 key: :frontend_configurations,
1248 "This form can be used to configure a keyword list that keeps the configuration data for any " <>
1249 "kind of frontend. By default, settings for pleroma_fe and masto_fe are configured. If you want to " <>
1250 "add your own configuration your settings all fields must be complete.",
1254 label: "Pleroma FE",
1256 description: "Settings for Pleroma FE",
1259 alwaysShowSubjectInput: true,
1260 background: "/static/aurora_borealis.jpg",
1261 collapseMessageWithSubject: false,
1264 hideFilteredStatuses: false,
1265 hideMutedPosts: false,
1266 hidePostStats: false,
1267 hideSitename: false,
1268 hideUserStats: false,
1269 loginMethod: "password",
1270 logo: "/static/logo.png",
1273 minimalScopesMode: false,
1274 noAttachmentLinks: false,
1275 nsfwCensorImage: "/static/img/nsfw.74818f9.png",
1276 postContentType: "text/plain",
1277 redirectRootLogin: "/main/friends",
1278 redirectRootNoLogin: "/main/all",
1280 sidebarRight: false,
1281 showFeaturesPanel: true,
1282 showInstanceSpecificPanel: false,
1283 subjectLineBehavior: "email",
1284 theme: "pleroma-dark",
1285 webPushNotifications: false
1290 key: :alwaysShowSubjectInput,
1291 label: "Always show subject input",
1293 description: "When disabled, auto-hide the subject field if it's empty"
1297 type: {:string, :image},
1299 "URL of the background, unless viewing a user profile with a background that is set",
1300 suggestions: ["/images/city.jpg"]
1303 key: :collapseMessageWithSubject,
1304 label: "Collapse message with subject",
1307 "When a message has a subject (aka Content Warning), collapse it by default"
1311 label: "PleromaFE Chat",
1313 description: "Disables PleromaFE Chat component"
1319 description: "Enables green text on lines prefixed with the > character"
1322 key: :hideFilteredStatuses,
1323 label: "Hide Filtered Statuses",
1325 description: "Hides filtered statuses from timelines"
1328 key: :hideMutedPosts,
1329 label: "Hide Muted Posts",
1331 description: "Hides muted statuses from timelines"
1334 key: :hidePostStats,
1335 label: "Hide post stats",
1337 description: "Hide notices statistics (repeats, favorites, ...)"
1341 label: "Hide Sitename",
1343 description: "Hides instance name from PleromaFE banner"
1346 key: :hideUserStats,
1347 label: "Hide user stats",
1350 "Hide profile statistics (posts, posts per day, followers, followings, ...)"
1354 type: {:string, :image},
1355 description: "URL of the logo, defaults to Pleroma's logo",
1356 suggestions: ["/static/logo.png"]
1360 label: "Logo margin",
1363 "Allows you to adjust vertical margins between logo boundary and navbar borders. " <>
1364 "The idea is that to have logo's image without any extra margins and instead adjust them to your need in layout.",
1365 suggestions: [".1em"]
1372 "By default it assumes logo used will be monochrome with alpha channel to be compatible with both light and dark themes. " <>
1373 "If you want a colorful logo you must disable logoMask."
1376 key: :minimalScopesMode,
1377 label: "Minimal scopes mode",
1380 "Limit scope selection to Direct, User default, and Scope of post replying to. " <>
1381 "Also prevents replying to a DM with a public post from PleromaFE."
1384 key: :nsfwCensorImage,
1385 label: "NSFW Censor Image",
1386 type: {:string, :image},
1388 "URL of the image to use for hiding NSFW media attachments in the timeline",
1389 suggestions: ["/static/img/nsfw.74818f9.png"]
1392 key: :postContentType,
1393 label: "Post Content Type",
1394 type: {:dropdown, :atom},
1395 description: "Default post formatting option",
1396 suggestions: ["text/plain", "text/html", "text/markdown", "text/bbcode"]
1399 key: :redirectRootNoLogin,
1400 label: "Redirect root no login",
1403 "Relative URL which indicates where to redirect when a user isn't logged in",
1404 suggestions: ["/main/all"]
1407 key: :redirectRootLogin,
1408 label: "Redirect root login",
1411 "Relative URL which indicates where to redirect when a user is logged in",
1412 suggestions: ["/main/friends"]
1416 label: "Scope copy",
1418 description: "Copy the scope (private/unlisted/public) in replies to posts by default"
1422 label: "Sidebar on Right",
1424 description: "Change alignment of sidebar and panels to the right"
1427 key: :showFeaturesPanel,
1428 label: "Show instance features panel",
1431 "Enables panel displaying functionality of the instance on the About page"
1434 key: :showInstanceSpecificPanel,
1435 label: "Show instance specific panel",
1437 description: "Whether to show the instance's custom panel"
1440 key: :subjectLineBehavior,
1441 label: "Subject line behavior",
1443 description: "Allows changing the default behaviour of subject lines in replies.
1444 `email`: copy and preprend re:, as in email,
1445 `masto`: copy verbatim, as in Mastodon,
1446 `noop`: don't copy the subject.",
1447 suggestions: ["email", "masto", "noop"]
1452 description: "Which theme to use. Available themes are defined in styles.json",
1453 suggestions: ["pleroma-dark"]
1461 description: "Settings for Masto FE",
1464 showInstanceSpecificPanel: true
1469 key: :showInstanceSpecificPanel,
1470 label: "Show instance specific panel",
1472 description: "Whenether to show the instance's specific panel"
1483 "This section configures assets to be used with various frontends. Currently the only option relates to mascots on the mastodon frontend",
1487 type: {:keyword, :map},
1489 "Keyword of mascots, each element must contain both an URL and a mime_type key",
1492 url: "/images/pleroma-fox-tan-smol.png",
1493 mime_type: "image/png"
1495 pleroma_fox_tan_shy: %{
1496 url: "/images/pleroma-fox-tan-shy.png",
1497 mime_type: "image/png"
1502 key: :default_mascot,
1505 "This will be used as the default mascot on MastoFE. Default: `:pleroma_fox_tan`",
1511 key: :default_user_avatar,
1512 type: {:string, :image},
1513 description: "URL of the default user avatar",
1514 suggestions: ["/images/avi.png"]
1523 "This section describe PWA manifest instance-specific values. Currently this option relate only for MastoFE.",
1527 type: {:list, :map},
1528 description: "Describe the icons of the app",
1531 src: "/static/logo.png"
1534 src: "/static/icon.png",
1538 src: "/static/icon.ico",
1539 sizes: "72x72 96x96 128x128 256x256"
1546 description: "Describe the theme color of the app",
1547 suggestions: ["#282c37", "mediumpurple"]
1550 key: :background_color,
1552 description: "Describe the background color of the app",
1553 suggestions: ["#191b22", "aliceblue"]
1561 description: "Media proxy",
1566 description: "Enables proxying of remote media to the instance's proxy"
1573 "The base URL to access a user-uploaded file. Useful when you want to proxy the media files via another host/CDN fronts.",
1574 suggestions: ["https://example.com"]
1582 provider: Pleroma.Web.MediaProxy.Invalidation.Script
1588 description: "Enables media cache object invalidation."
1593 description: "Module which will be used to purge objects from the cache.",
1595 Pleroma.Web.MediaProxy.Invalidation.Script,
1596 Pleroma.Web.MediaProxy.Invalidation.Http
1603 label: "Proxy Options",
1605 description: "Options for Pleroma.ReverseProxy",
1607 redirect_on_failure: false,
1608 max_body_length: 25 * 1_048_576,
1609 max_read_duration: 30_000,
1611 follow_redirect: true,
1617 key: :redirect_on_failure,
1620 "Redirects the client to the real remote URL if there's any HTTP errors. " <>
1621 "Any error during body processing will not be redirected as the response is chunked."
1624 key: :max_body_length,
1627 "Limits the content length to be approximately the " <>
1628 "specified length. It is validated with the `content-length` header and also verified when proxying."
1631 key: :max_read_duration,
1633 description: "Timeout (in milliseconds) of GET request to remote URI."
1639 description: "HTTP options",
1644 description: "Adapter specific options",
1649 label: "SSL Options",
1650 description: "SSL options for HTTP adapter",
1654 type: {:list, :atom},
1655 description: "List of TLS version to use",
1656 suggestions: [:tlsv1, ":tlsv1.1", ":tlsv1.2"]
1665 type: [:string, :tuple],
1666 description: "Proxy URL",
1667 suggestions: ["127.0.0.1:8123", {:socks5, :localhost, 9050}]
1675 type: {:list, :string},
1676 description: "List of hosts with scheme to bypass the mediaproxy",
1677 suggestions: ["http://example.com"]
1683 key: :media_preview_proxy,
1685 description: "Media preview proxy",
1691 "Enables proxying of remote media preview to the instance's proxy. Requires enabled media proxy."
1694 key: :thumbnail_max_width,
1697 "Max width of preview thumbnail for images (video preview always has original dimensions)."
1700 key: :thumbnail_max_height,
1703 "Max height of preview thumbnail for images (video preview always has original dimensions)."
1706 key: :image_quality,
1708 description: "Quality of the output. Ranges from 0 (min quality) to 100 (max quality)."
1711 key: :min_content_length,
1714 "Min content length to perform preview, in bytes. If greater than 0, media smaller in size will be served as is, without thumbnailing."
1720 key: Pleroma.Web.MediaProxy.Invalidation.Http,
1722 description: "HTTP invalidate settings",
1727 description: "HTTP method of request. Default: :purge"
1731 type: {:keyword, :string},
1732 description: "HTTP headers of request",
1733 suggestions: [{"x-refresh", 1}]
1738 description: "Request options",
1742 type: {:map, :string}
1750 key: Pleroma.Web.MediaProxy.Invalidation.Script,
1752 description: "Script invalidate settings",
1757 description: "Path to shell script. Which will run purge cache.",
1758 suggestions: ["./installation/nginx-cache-purge.sh.example"]
1766 description: "Gopher settings",
1771 description: "Enables the gopher interface"
1777 description: "IP address to bind to",
1778 suggestions: [{0, 0, 0, 0}]
1783 description: "Port to bind to",
1789 description: "Port advertised in URLs (optional, defaults to port)",
1797 label: "ActivityPub",
1799 description: "ActivityPub-related settings",
1802 key: :unfollow_blocked,
1804 description: "Whether blocks result in people getting unfollowed"
1807 key: :outgoing_blocks,
1809 description: "Whether to federate blocks to other instances"
1812 key: :sign_object_fetches,
1814 description: "Sign object fetches with HTTP signatures"
1817 key: :note_replies_output_limit,
1820 "The number of Note replies' URIs to be included with outgoing federation (`5` to match Mastodon hardcoded value, `0` to disable the output)"
1823 key: :follow_handshake_timeout,
1825 description: "Following handshake timeout",
1832 key: :http_security,
1833 label: "HTTP security",
1835 description: "HTTP security settings",
1840 description: "Whether the managed content security policy is enabled"
1846 description: "Whether to additionally send a Strict-Transport-Security header"
1850 label: "STS max age",
1852 description: "The maximum age for the Strict-Transport-Security header if sent",
1853 suggestions: [31_536_000]
1857 label: "CT max age",
1859 description: "The maximum age for the Expect-CT header if sent",
1860 suggestions: [2_592_000]
1863 key: :referrer_policy,
1865 description: "The referrer policy to use, either \"same-origin\" or \"no-referrer\"",
1866 suggestions: ["same-origin", "no-referrer"]
1870 label: "Report URI",
1872 description: "Adds the specified URL to report-uri and report-to group in CSP header",
1873 suggestions: ["https://example.com/report-uri"]
1878 group: :web_push_encryption,
1879 key: :vapid_details,
1880 label: "Vapid Details",
1883 "Web Push Notifications configuration. You can use the mix task mix web_push.gen.keypair to generate it.",
1889 "A mailto link for the administrative contact." <>
1890 " It's best if this email is not a personal email address, but rather a group email to the instance moderation team.",
1891 suggestions: ["mailto:moderators@pleroma.com"]
1896 description: "VAPID public key",
1897 suggestions: ["Public key"]
1902 description: "VAPID private key",
1903 suggestions: ["Private key"]
1909 key: Pleroma.Captcha,
1911 description: "Captcha-related settings",
1916 description: "Whether the captcha should be shown on registration"
1921 description: "The method/service to use for captcha",
1922 suggestions: [Pleroma.Captcha.Kocaptcha, Pleroma.Captcha.Native]
1925 key: :seconds_valid,
1927 description: "The time in seconds for which the captcha is valid",
1934 key: Pleroma.Captcha.Kocaptcha,
1937 "Kocaptcha is a very simple captcha service with a single API endpoint, the source code is" <>
1938 " here: https://github.com/koto-bank/kocaptcha. The default endpoint (https://captcha.kotobank.ch) is hosted by the developer.",
1943 description: "The kocaptcha endpoint to use",
1944 suggestions: ["https://captcha.kotobank.ch"]
1950 label: "Pleroma Admin Token",
1953 "Allows setting a token that can be used to authenticate requests with admin privileges without a normal user account token. Append the `admin_token` parameter to requests to utilize it. (Please reconsider using HTTP Basic Auth or OAuth-based authentication if possible)",
1958 description: "Admin token",
1960 "Please use a high entropy string or UUID"
1970 [Oban](https://github.com/sorentwo/oban) asynchronous job processor configuration.
1972 Note: if you are running PostgreSQL in [`silent_mode`](https://postgresqlco.nf/en/doc/param/silent_mode?version=9.1),
1973 it's advised to set [`log_destination`](https://postgresqlco.nf/en/doc/param/log_destination?version=9.1) to `syslog`,
1974 otherwise `postmaster.log` file may grow because of "you don't own a lock of type ShareLock" warnings
1975 (see https://github.com/sorentwo/oban/issues/52).
1980 type: {:dropdown, :atom},
1981 description: "Logs verbose mode",
1982 suggestions: [false, :error, :warn, :info, :debug]
1986 type: {:keyword, :integer},
1988 "Background jobs queues (keys: queues, values: max numbers of concurrent jobs)",
1990 activity_expiration: 10,
1991 attachments_cleanup: 5,
1993 federator_incoming: 50,
1994 federator_outgoing: 50,
1996 scheduled_activities: 10,
2002 key: :activity_expiration,
2004 description: "Activity expiration queue",
2010 description: "Backup queue",
2014 key: :attachments_cleanup,
2016 description: "Attachment deletion queue",
2022 description: "Background queue",
2026 key: :federator_incoming,
2028 description: "Incoming federation queue",
2032 key: :federator_outgoing,
2034 description: "Outgoing federation queue",
2040 description: "Email sender queue, see Pleroma.Emails.Mailer",
2044 key: :scheduled_activities,
2046 description: "Scheduled activities queue, see Pleroma.ScheduledActivities",
2050 key: :transmogrifier,
2052 description: "Transmogrifier queue",
2058 description: "Web push notifications queue",
2065 type: {:list, :tuple},
2066 description: "Settings for cron background jobs",
2068 {"0 0 * * 0", Pleroma.Workers.Cron.DigestEmailsWorker},
2069 {"0 0 * * *", Pleroma.Workers.Cron.NewUsersDigestWorker}
2078 description: "Includes custom worker options not interpretable directly by `Oban`",
2082 type: {:keyword, :integer},
2083 description: "Max retry attempts for failed jobs, per `Oban` queue",
2085 federator_incoming: 5,
2086 federator_outgoing: 5
2093 key: Pleroma.Web.Metadata,
2095 description: "Metadata-related settings",
2099 type: {:list, :module},
2100 description: "List of metadata providers to enable",
2102 Pleroma.Web.Metadata.Providers.OpenGraph,
2103 Pleroma.Web.Metadata.Providers.TwitterCard,
2104 Pleroma.Web.Metadata.Providers.RelMe,
2105 Pleroma.Web.Metadata.Providers.Feed
2110 label: "Unfurl NSFW",
2112 description: "When enabled NSFW attachments will be shown in previews"
2121 "If enabled the instance will parse metadata from attached links to generate link previews",
2126 description: "Enables RichMedia parsing of URLs"
2130 type: {:list, :string},
2131 description: "List of hosts which will be ignored by the metadata parser",
2132 suggestions: ["accounts.google.com", "xss.website"]
2136 label: "Ignore TLD",
2137 type: {:list, :string},
2138 description: "List TLDs (top-level domains) which will ignore for parse metadata",
2139 suggestions: ["local", "localdomain", "lan"]
2143 type: {:list, :module},
2145 "List of Rich Media parsers. Module names are shortened (removed leading `Pleroma.Web.RichMedia.Parsers.` part), but on adding custom module you need to use full name.",
2147 Pleroma.Web.RichMedia.Parsers.OEmbed,
2148 Pleroma.Web.RichMedia.Parsers.TwitterCard
2153 label: "TTL setters",
2154 type: {:list, :module},
2156 "List of rich media TTL setters. Module names are shortened (removed leading `Pleroma.Web.RichMedia.Parser.` part), but on adding custom module you need to use full name.",
2158 Pleroma.Web.RichMedia.Parser.TTL.AwsSignedUrl
2162 key: :failure_backoff,
2165 "Amount of milliseconds after request failure, during which the request will not be retried.",
2166 suggestions: [60_000]
2172 key: Pleroma.Formatter,
2176 "Configuration for Pleroma's link formatter which parses mentions, hashtags, and URLs.",
2180 type: [:string, :boolean],
2181 description: "Specify the class to be added to the generated link. Disable to clear.",
2182 suggestions: ["auto-linker", false]
2186 type: [:string, :boolean],
2187 description: "Override the rel attribute. Disable to clear.",
2188 suggestions: ["ugc", "noopener noreferrer", false]
2193 description: "Link URLs will open in a new window/tab."
2197 type: [:integer, :boolean],
2199 "Set to a number to truncate URLs longer than the number. Truncated URLs will end in `...`",
2200 suggestions: [15, false]
2205 description: "Strip the scheme prefix."
2210 description: "Link URLs with rarely used schemes (magnet, ipfs, irc, etc.)"
2214 type: [:atom, :boolean],
2216 "Set to false to disable TLD validation for URLs/emails. Can be set to :no_scheme to validate TLDs only for URLs without a scheme (e.g `example.com` will be validated, but `http://example.loki` won't)",
2217 suggestions: [:no_scheme, true]
2223 key: Pleroma.ScheduledActivity,
2225 description: "Scheduled activities settings",
2228 key: :daily_user_limit,
2231 "The number of scheduled activities a user is allowed to create in a single day. Default: 25.",
2235 key: :total_user_limit,
2238 "The number of scheduled activities a user is allowed to create in total. Default: 300.",
2244 description: "Whether scheduled activities are sent to the job queue to be executed"
2250 key: Pleroma.Workers.PurgeExpiredActivity,
2252 description: "Expired activities settings",
2257 description: "Enables expired activities addition & deletion"
2262 description: "Minimum lifetime for ephemeral activity (in seconds)",
2269 label: "Pleroma Authenticator",
2271 description: "Authenticator",
2274 key: Pleroma.Web.Auth.Authenticator,
2276 suggestions: [Pleroma.Web.Auth.PleromaAuthenticator, Pleroma.Web.Auth.LDAPAuthenticator]
2286 "Use LDAP for user authentication. When a user logs in to the Pleroma instance, the name and password" <>
2287 " will be verified by trying to authenticate (bind) to a LDAP server." <>
2288 " If a user exists in the LDAP directory but there is no account with the same name yet on the" <>
2289 " Pleroma instance then a new Pleroma account will be created with the same name as the LDAP user name.",
2294 description: "Enables LDAP authentication"
2299 description: "LDAP server hostname",
2300 suggestions: ["localhosts"]
2305 description: "LDAP port, e.g. 389 or 636",
2306 suggestions: [389, 636]
2312 description: "Enable to use SSL, usually implies the port 636"
2316 label: "SSL options",
2318 description: "Additional SSL options",
2319 suggestions: [cacertfile: "path/to/file/with/PEM/cacerts", verify: :verify_peer],
2324 description: "Path to file with PEM encoded cacerts",
2325 suggestions: ["path/to/file/with/PEM/cacerts"]
2330 description: "Type of cert verification",
2331 suggestions: [:verify_peer]
2339 description: "Enable to use STARTTLS, usually implies the port 389"
2343 label: "TLS options",
2345 description: "Additional TLS options",
2346 suggestions: [cacertfile: "path/to/file/with/PEM/cacerts", verify: :verify_peer],
2351 description: "Path to file with PEM encoded cacerts",
2352 suggestions: ["path/to/file/with/PEM/cacerts"]
2357 description: "Type of cert verification",
2358 suggestions: [:verify_peer]
2365 description: "LDAP base, e.g. \"dc=example,dc=com\"",
2366 suggestions: ["dc=example,dc=com"]
2373 "LDAP attribute name to authenticate the user, e.g. when \"cn\", the filter will be \"cn=username,base\"",
2382 description: "Authentication / authorization settings",
2385 key: :enforce_oauth_admin_scope_usage,
2386 label: "Enforce OAuth admin scope usage",
2389 "OAuth admin scope requirement toggle. " <>
2390 "If enabled, admin actions explicitly demand admin OAuth scope(s) presence in OAuth token " <>
2391 "(client app must support admin scopes). If disabled and token doesn't have admin scope(s), " <>
2392 "`is_admin` user flag grants access to admin-specific actions."
2395 key: :auth_template,
2398 "Authentication form template. By default it's `show.html` which corresponds to `lib/pleroma/web/templates/o_auth/o_auth/show.html.ee`.",
2399 suggestions: ["show.html"]
2402 key: :oauth_consumer_template,
2403 label: "OAuth consumer template",
2406 "OAuth consumer mode authentication form template. By default it's `consumer.html` which corresponds to" <>
2407 " `lib/pleroma/web/templates/o_auth/o_auth/consumer.html.eex`.",
2408 suggestions: ["consumer.html"]
2411 key: :oauth_consumer_strategies,
2412 label: "OAuth consumer strategies",
2413 type: {:list, :string},
2415 "The list of enabled OAuth consumer strategies. By default it's set by OAUTH_CONSUMER_STRATEGIES environment variable." <>
2416 " Each entry in this space-delimited string should be of format \"strategy\" or \"strategy:dependency\"" <>
2417 " (e.g. twitter or keycloak:ueberauth_keycloak_strategy in case dependency is named differently than ueberauth_<strategy>).",
2418 suggestions: ["twitter", "keycloak:ueberauth_keycloak_strategy"]
2424 key: :email_notifications,
2426 description: "Email notifications settings",
2432 "emails of \"what you've missed\" for users who have been inactive for a while",
2436 schedule: "0 0 * * 0",
2438 inactivity_threshold: 7
2446 description: "Globally enable or disable digest emails"
2452 "When to send digest email, in crontab format. \"0 0 0\" is the default, meaning \"once a week at midnight on Sunday morning\".",
2453 suggestions: ["0 0 * * 0"]
2458 description: "Minimum interval between digest emails to one user",
2462 key: :inactivity_threshold,
2464 description: "Minimum user inactivity threshold",
2473 key: Pleroma.Emails.UserEmail,
2475 description: "Email template settings",
2479 type: {:string, :image},
2480 description: "A path to a custom logo. Set it to `nil` to use the default Pleroma logo.",
2481 suggestions: ["some/path/logo.png"]
2486 description: "A map with color settings for email templates.",
2489 link_color: "#d8a070",
2490 background_color: "#2C3645",
2491 content_background_color: "#1B2635",
2492 header_color: "#d8a070",
2493 text_color: "#b9b9ba",
2494 text_muted_color: "#b9b9ba"
2501 suggestions: ["#d8a070"]
2504 key: :background_color,
2506 suggestions: ["#2C3645"]
2509 key: :content_background_color,
2511 suggestions: ["#1B2635"]
2516 suggestions: ["#d8a070"]
2521 suggestions: ["#b9b9ba"]
2524 key: :text_muted_color,
2526 suggestions: ["#b9b9ba"]
2534 key: Pleroma.Emails.NewUsersDigestEmail,
2536 description: "New users admin email digest",
2541 description: "Enables new users admin digest email when `true`"
2550 description: "Configure OAuth 2 provider capabilities",
2553 key: :token_expires_in,
2555 description: "The lifetime in seconds of the access token",
2559 key: :issue_new_refresh_token,
2562 "Keeps old refresh token or generate new refresh token when to obtain an access token"
2565 key: :clean_expired_tokens,
2567 description: "Enable a background job to clean expired OAuth tokens. Default: disabled."
2577 key: :shortcode_globs,
2578 type: {:list, :string},
2579 description: "Location of custom emoji files. * can be used as a wildcard.",
2580 suggestions: ["/emoji/custom/**/*.png"]
2583 key: :pack_extensions,
2584 type: {:list, :string},
2586 "A list of file extensions for emojis, when no emoji.txt for a pack is present",
2587 suggestions: [".png", ".gif"]
2591 type: {:keyword, {:list, :string}},
2593 "Emojis are ordered in groups (tags). This is an array of key-value pairs where the key is the group name" <>
2594 " and the value is the location or array of locations. * can be used as a wildcard.",
2596 Custom: ["/emoji/*.png", "/emoji/**/*.png"]
2600 key: :default_manifest,
2603 "Location of the JSON-manifest. This manifest contains information about the emoji-packs you can download." <>
2604 " Currently only one manifest can be added (no arrays).",
2605 suggestions: ["https://git.pleroma.social/pleroma/emoji-index/raw/master/index.json"]
2608 key: :shared_pack_cache_seconds_per_file,
2609 label: "Shared pack cache s/file",
2612 "When an emoji pack is shared, the archive is created and cached in memory" <>
2613 " for this amount of seconds multiplied by the number of files.",
2623 "Rate limit settings. This is an advanced feature enabled only for :authentication by default.",
2627 type: [:tuple, {:list, :tuple}],
2628 description: "For the search requests (account & status search etc.)",
2629 suggestions: [{1000, 10}, [{10_000, 10}, {10_000, 50}]]
2633 type: [:tuple, {:list, :tuple}],
2634 description: "For requests to timelines (each timeline has it's own limiter)",
2635 suggestions: [{1000, 10}, [{10_000, 10}, {10_000, 50}]]
2638 key: :app_account_creation,
2639 type: [:tuple, {:list, :tuple}],
2640 description: "For registering user accounts from the same IP address",
2641 suggestions: [{1000, 10}, [{10_000, 10}, {10_000, 50}]]
2644 key: :relations_actions,
2645 type: [:tuple, {:list, :tuple}],
2646 description: "For actions on relationships with all users (follow, unfollow)",
2647 suggestions: [{1000, 10}, [{10_000, 10}, {10_000, 50}]]
2650 key: :relation_id_action,
2651 label: "Relation ID action",
2652 type: [:tuple, {:list, :tuple}],
2653 description: "For actions on relation with a specific user (follow, unfollow)",
2654 suggestions: [{1000, 10}, [{10_000, 10}, {10_000, 50}]]
2657 key: :statuses_actions,
2658 type: [:tuple, {:list, :tuple}],
2660 "For create / delete / fav / unfav / reblog / unreblog actions on any statuses",
2661 suggestions: [{1000, 10}, [{10_000, 10}, {10_000, 50}]]
2664 key: :status_id_action,
2665 label: "Status ID action",
2666 type: [:tuple, {:list, :tuple}],
2668 "For fav / unfav or reblog / unreblog actions on the same status by the same user",
2669 suggestions: [{1000, 10}, [{10_000, 10}, {10_000, 50}]]
2672 key: :authentication,
2673 type: [:tuple, {:list, :tuple}],
2674 description: "For authentication create / password check / user existence check requests",
2675 suggestions: [{60_000, 15}]
2684 "Before enabling this you must add :esshd to mix.exs as one of the extra_applications " <>
2685 "and generate host keys in your priv dir with ssh-keygen -m PEM -N \"\" -b 2048 -t rsa -f ssh_host_rsa_key",
2690 description: "Enables SSH"
2695 description: "Dir with SSH keys",
2696 suggestions: ["/some/path/ssh_keys"]
2701 description: "Handler module",
2702 suggestions: ["Pleroma.BBS.Handler"]
2707 description: "Port to connect",
2708 suggestions: [10_022]
2711 key: :password_authenticator,
2713 description: "Authenticator module",
2714 suggestions: ["Pleroma.BBS.Authenticator"]
2720 label: "Mime Types",
2722 description: "Mime Types settings",
2729 "application/xml" => ["xml"],
2730 "application/xrd+xml" => ["xrd+xml"],
2731 "application/jrd+json" => ["jrd+json"],
2732 "application/activity+json" => ["activity+json"],
2733 "application/ld+json" => ["activity+json"]
2738 key: "application/xml",
2739 type: {:list, :string},
2740 suggestions: ["xml"]
2743 key: "application/xrd+xml",
2744 type: {:list, :string},
2745 suggestions: ["xrd+xml"]
2748 key: "application/jrd+json",
2749 type: {:list, :string},
2750 suggestions: ["jrd+json"]
2753 key: "application/activity+json",
2754 type: {:list, :string},
2755 suggestions: ["activity+json"]
2758 key: "application/ld+json",
2759 type: {:list, :string},
2760 suggestions: ["activity+json"]
2770 description: "Pleroma chat settings",
2783 description: "HTTP settings",
2788 type: [:string, :tuple],
2789 description: "Proxy URL",
2790 suggestions: ["localhost:9020", {:socks5, :localhost, 3090}]
2793 key: :send_user_agent,
2798 type: [:string, :atom],
2800 "What user agent to use. Must be a string or an atom `:default`. Default value is `:default`.",
2801 suggestions: ["Pleroma", :default]
2806 description: "Adapter specific options",
2812 label: "SSL Options",
2813 description: "SSL options for HTTP adapter",
2817 type: {:list, :atom},
2818 description: "List of TLS version to use",
2819 suggestions: [:tlsv1, ":tlsv1.1", ":tlsv1.2"]
2830 label: "Markup Settings",
2834 key: :allow_inline_images,
2838 key: :allow_headings,
2851 type: {:list, :module},
2853 "Module names are shortened (removed leading `Pleroma.HTML.` part), but on adding custom module you need to use full name.",
2854 suggestions: [Pleroma.HTML.Transform.MediaProxy, Pleroma.HTML.Scrubber.Default]
2864 key: :deny_follow_blocked,
2875 key: :restricted_nicknames,
2876 type: {:list, :string},
2877 description: "List of nicknames users may not register with.",
2896 "ostatus_subscribe",
2912 key: :email_blacklist,
2913 type: {:list, :string},
2914 description: "List of email domains users may not register with.",
2915 suggestions: ["mailinator.com", "maildrop.cc"]
2921 label: "CORS plug config",
2927 suggestions: [86_400]
2931 type: {:list, :string},
2932 suggestions: ["POST", "PUT", "DELETE", "GET", "PATCH", "OPTIONS"]
2936 type: {:list, :string},
2939 "X-RateLimit-Reset",
2940 "X-RateLimit-Limit",
2941 "X-RateLimit-Remaining",
2952 type: {:list, :string},
2953 suggestions: ["Authorization", "Content-Type", "Idempotency-Key"]
2959 key: Pleroma.Web.Plugs.RemoteIp,
2962 `Pleroma.Web.Plugs.RemoteIp` is a shim to call [`RemoteIp`](https://git.pleroma.social/pleroma/remote_ip) but with runtime configuration.
2963 **If your instance is not behind at least one reverse proxy, you should not enable this plug.**
2969 description: "Enable/disable the plug. Default: disabled."
2973 type: {:list, :string},
2975 A list of strings naming the HTTP headers to use when deriving the true client IP. Default: `["x-forwarded-for"]`.
2980 type: {:list, :string},
2982 "A list of upstream proxy IP subnets in CIDR notation from which we will parse the content of `headers`. Defaults to `[]`. IPv4 entries without a bitmask will be assumed to be /32 and IPv6 /128."
2986 type: {:list, :string},
2988 A list of reserved IP subnets in CIDR notation which should be ignored if found in `headers`. Defaults to `["127.0.0.0/8", "::1/128", "fc00::/7", "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"]`
2995 key: :web_cache_ttl,
2996 label: "Web cache TTL",
2999 "The expiration time for the web responses cache. Values should be in milliseconds or `nil` to disable expiration.",
3005 "Activity pub routes (except question activities). Default: `nil` (no expiration).",
3006 suggestions: [30_000, nil]
3009 key: :activity_pub_question,
3011 description: "Activity pub routes (question activities). Default: `30_000` (30 seconds).",
3012 suggestions: [30_000]
3022 "Render profiles and posts using server-generated HTML that is viewable without using JavaScript",
3027 description: "Enables the rendering of static HTML. Default: disabled."
3035 description: "Configure feed rendering",
3040 description: "Configure title rendering",
3045 description: "Maximum number of characters before truncating title",
3051 description: "Replacement which will be used after truncating string",
3052 suggestions: ["..."]
3062 description: "Custom Runtime Modules",
3067 description: "A path to custom Elixir modules (such as MRF policies)."
3075 description: "Settings for notifications streamer",
3080 description: "Number of workers to send notifications",
3084 key: :overflow_workers,
3086 description: "Maximum number of workers created if pool is empty",
3093 key: :connections_pool,
3095 description: "Advanced settings for `Gun` connections pool",
3098 key: :connection_acquisition_wait,
3101 "Timeout to acquire a connection from pool. The total max time is this value multiplied by the number of retries. Default: 250ms.",
3105 key: :connection_acquisition_retries,
3108 "Number of attempts to acquire the connection from the pool if it is overloaded. Default: 5",
3112 key: :max_connections,
3114 description: "Maximum number of connections in the pool. Default: 250 connections.",
3118 key: :connect_timeout,
3120 description: "Timeout while `gun` will wait until connection is up. Default: 5000ms.",
3124 key: :reclaim_multiplier,
3127 "Multiplier for the number of idle connection to be reclaimed if the pool is full. For example if the pool maxes out at 250 connections and this setting is set to 0.3, the pool will reclaim at most 75 idle connections if it's overloaded. Default: 0.1",
3136 description: "Advanced settings for `Gun` workers pools",
3138 Enum.map([:federation, :media, :upload, :default], fn pool_name ->
3142 description: "Settings for #{pool_name} pool.",
3147 description: "Maximum number of concurrent requests in the pool.",
3154 "Maximum number of requests waiting for other requests to finish. After this number is reached, the pool will start returning errrors when a new request is made",
3160 description: "Timeout for the pool while gun will wait for response",
3161 suggestions: [10_000]
3169 key: :hackney_pools,
3171 description: "Advanced settings for `Hackney` connections pools",
3176 description: "Settings for federation pool.",
3179 key: :max_connections,
3181 description: "Number workers in the pool.",
3187 description: "Timeout while `hackney` will wait for response.",
3188 suggestions: [150_000]
3195 description: "Settings for media pool.",
3198 key: :max_connections,
3200 description: "Number workers in the pool.",
3206 description: "Timeout while `hackney` will wait for response.",
3207 suggestions: [150_000]
3214 description: "Settings for upload pool.",
3217 key: :max_connections,
3219 description: "Number workers in the pool.",
3225 description: "Timeout while `hackney` will wait for response.",
3226 suggestions: [300_000]
3234 key: :restrict_unauthenticated,
3235 label: "Restrict Unauthenticated",
3238 "Disallow viewing timelines, user profiles and statuses for unauthenticated users.",
3243 description: "Settings for public and federated timelines.",
3248 description: "Disallow view public timeline."
3253 description: "Disallow view federated timeline."
3260 description: "Settings for user profiles.",
3265 description: "Disallow view local user profiles."
3270 description: "Disallow view remote user profiles."
3277 description: "Settings for statuses.",
3282 description: "Disallow view local statuses."
3287 description: "Disallow view remote statuses."
3295 key: Pleroma.Web.ApiSpec.CastAndValidate,
3302 "Enables strict input validation (useful in development, not recommended in production)"
3308 key: :instances_favicons,
3310 description: "Control favicons for instances",
3315 description: "Allow/disallow displaying and getting instances favicons"
3323 descriptions: "S3 service related settings",
3326 key: :access_key_id,
3328 description: "S3 access key ID",
3329 suggestions: ["AKIAQ8UKHTGIYN7DMWWJ"]
3332 key: :secret_access_key,
3334 description: "Secret access key",
3335 suggestions: ["JFGt+fgH1UQ7vLUQjpW+WvjTdV/UNzVxcwn7DkaeFKtBS5LvoXvIiME4NQBsT6ZZ"]
3340 description: "S3 host",
3341 suggestions: ["s3.eu-central-1.amazonaws.com"]
3349 description: "Installed frontends management",
3354 description: "Primary frontend, the one that is served for all pages by default",
3355 children: installed_frontend_options
3360 description: "Admin frontend",
3361 children: installed_frontend_options
3367 "A map containing available frontends and parameters for their installation.",
3368 children: frontend_options
3374 key: Pleroma.Web.Preload,
3376 description: "Preload-related settings",
3380 type: {:list, :module},
3381 description: "List of preload providers to enable",
3383 Pleroma.Web.Preload.Providers.Instance,
3384 Pleroma.Web.Preload.Providers.User,
3385 Pleroma.Web.Preload.Providers.Timelines,
3386 Pleroma.Web.Preload.Providers.StatusNet
3395 description: "Majic/libmagic configuration",
3400 description: "Number of majic workers to start.",
3407 key: Pleroma.User.Backup,
3409 description: "Account Backup",
3412 key: :purge_after_days,
3414 description: "Remove backup achives after N days",
3420 description: "Limit user to export not more often than once per N days",
3427 key: Pleroma.Web.Endpoint.MetricsExporter,
3429 description: "Prometheus app metrics endpoint configuration",
3434 description: "[Pleroma extension] Enables app metrics endpoint."
3438 type: [{:list, :string}, {:list, :charlist}, {:list, :tuple}],
3440 "[Pleroma extension] If non-empty, restricts access to app metrics endpoint to specified IP addresses."
3444 type: [:boolean, :tuple],
3445 description: "Enables HTTP Basic Auth for app metrics endpoint.",
3446 suggestion: [false, {:basic, "myusername", "mypassword"}]
3451 description: "App metrics endpoint URI path.",
3452 suggestions: ["/api/pleroma/app_metrics"]
3457 description: "App metrics endpoint output format.",
3458 suggestions: [:text, :protobuf]