]> git.mxchange.org Git - friendica.git/blob - static/defaults.config.php
Merge pull request #9293 from annando/issue-9288
[friendica.git] / static / defaults.config.php
1 <?php
2 /**
3  * @copyright Copyright (C) 2020, Friendica
4  *
5  * @license GNU AGPL version 3 or any later version
6  *
7  * This program is free software: you can redistribute it and/or modify
8  * it under the terms of the GNU Affero General Public License as
9  * published by the Free Software Foundation, either version 3 of the
10  * License, or (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU Affero General Public License for more details.
16  *
17  * You should have received a copy of the GNU Affero General Public License
18  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
19  *
20  * This file declares the default values for the base config of Friendica.
21  *
22  * These configuration values aren't accessible from the admin settings page and custom values must be set in config/local.config.php
23  *
24  * Please don't edit this file directly as its content may change in the upcoming versions.
25  *
26  */
27
28 return [
29         'database' => [
30                 // host (String)
31                 // Hostname or IP address of the database server.
32                 // Can contain the port number with the syntax "hostname:port".
33                 'hostname' => '',
34
35                 // user (String)
36                 // Database user name. Please don't use "root".
37                 'username' => '',
38
39                 // pass (String)
40                 // Database user password. Please don't use empty passwords.
41                 'password' => '',
42
43                 // base (String)
44                 // Database name.
45                 'database' => '',
46
47                 // charset (String)
48                 // Database connection charset. Changing this value will likely corrupt special characters.
49                 'charset' => 'utf8mb4',
50
51                 // emulate_prepares (Boolean) (Experimental)
52                 // If enabled, prepared statements will be emulated.
53                 // In combination with MySQLi this will cast all return values to strings.
54                 'emulate_prepares' => false,
55
56                 // pdo_emulate_prepares (Boolean) (Experimental)
57                 // If enabled, the builtin emulation for prepared statements is used.
58                 // Due to limitations of that emulation (all return values are casted as strings)
59                 // this will most likely cause issues and should not be used on production systems.
60                 'pdo_emulate_prepares' => false,
61
62                 // disable_pdo (Boolean)
63                 // PDO is used by default (if available). Otherwise MySQLi will be used.
64                 'disable_pdo' => false,
65
66                 // persistent (Boolean)
67                 // This controls if the system should use persistent connections or not.
68                 // Persistent connections increase the performance.
69                 // On the other hand the number of open connections are higher,
70                 // this will most likely increase the system load.
71                 'persistent' => false,
72         ],
73         'config' => [
74                 // admin_email (Comma-separated list)
75                 // In order to perform system administration via the admin panel,
76                 // this must precisely match the email address of the person logged in.
77                 'admin_email' => '',
78
79                 // admin_nickname (String)
80                 // Nickname of the main admin user, used if there are more than one admin user defined in config => admin_email.
81                 'admin_nickname' => '',
82
83                 // max_import_size (Integer)
84                 // Maximum body size of DFRN and Mail messages in characters. 0 is unlimited.
85                 'max_import_size' => 200000,
86
87                 // php_path (String)
88                 // Location of PHP command line processor.
89                 'php_path' => 'php',
90         ],
91         'system' => [
92                 // adjust_poll_frequency (Boolean)
93                 // Automatically detect and set the best feed poll frequency.
94                 'adjust_poll_frequency' => false,
95
96                 // allowed_link_protocols (Array)
97                 // Allowed protocols in links URLs, add at your own risk. http(s) is always allowed.
98                 'allowed_link_protocols' => ['ftp://', 'ftps://', 'mailto:', 'cid:', 'gopher://'],
99
100                 // always_show_preview (Boolean)
101                 // Only show small preview pictures.
102                 'always_show_preview' => false,
103
104                 // ap_always_bcc (Boolean)
105                 // Adresses non-mentioned ActivityPub receivers by BCC instead of CC. Increases privacy, decreases performance.
106                 'ap_always_bcc' => false,
107
108                 // archival_days (Integer)
109                 // Number of days that we try to deliver content before we archive a contact.
110                 'archival_days' => 32,
111
112                 // auth_cookie_lifetime (Integer)
113                 // Number of days that should pass without any activity before a user who
114                 // chose "Remember me" when logging in is considered logged out.
115                 'auth_cookie_lifetime' => 7,
116
117                 // big_emojis (Boolean)
118                 // Display "Emoji Only" posts in big.
119                 'big_emojis' => false,
120
121                 // block_local_dir (Boolean)
122                 // Deny public access to the local user directory.
123                 'block_local_dir' => false,
124
125                 // community_no_sharer (Boolean)
126                 // Don't display sharing accounts on the global community
127                 'community_no_sharer' => false,
128
129                 // cron_interval (Integer)
130                 // Minimal period in minutes between two calls of the "Cron" worker job.
131                 'cron_interval' => 5,
132
133                 // cache_driver (database|memcache|memcached|redis|apcu)
134                 // Whether to use Memcache, Memcached, Redis or APCu to store temporary cache.
135                 'cache_driver' => 'database',
136
137                 // config_adapter (jit|preload)
138                 // Allow to switch the configuration adapter to improve performances at the cost of memory consumption.
139                 'config_adapter' => 'jit',
140
141                 // curl_range_bytes (Integer)
142                 // Maximum number of bytes that should be fetched. Default is 0, which mean "no limit".
143                 'curl_range_bytes' => 0,
144
145                 // crawl_permit_period (Integer)
146                 // Period in seconds between allowed searches when the number of free searches is reached and "permit_crawling" is activated.
147                 'crawl_permit_period' => 60,
148
149                 // db_log (Path)
150                 // Name of a logfile to log slow database queries.
151                 'db_log' => '',
152
153                 // db_log_index (Path)
154                 // Name of a logfile to log queries with bad indexes.
155                 'db_log_index' => '',
156
157                 // db_log_index_watch (Comma-separated list)
158                 // Watchlist of indexes to watch.
159                 'db_log_index_watch' => '',
160
161                 // db_log_index_denylist (Comma-separated list)
162                 // Deny list of indexes that shouldn't be watched.
163                 'db_log_index_denylist' => '',
164
165                 // db_loglimit (Integer)
166                 // If a database call lasts longer than this value in seconds it is logged.
167                 // Inactive if system => db_log is empty.
168                 'db_loglimit' => 10,
169
170                 // db_loglimit_index (Integer)
171                 // Number of index rows needed to be logged for indexes on the watchlist. 0 to disable.
172                 'db_loglimit_index' => 0,
173
174                 // db_loglimit_index_high (Integer)
175                 // Number of index rows to be logged anyway (for any index). 0 to disable.
176                 'db_loglimit_index_high' => 0,
177
178                 // dbclean_expire_conversation (Integer)
179                 // When DBClean is enabled, any entry in the conversation table will be deleted after this many days.
180                 // This data is used for ActivityPub, so it shouldn't be lower than the average duration of a discussion.
181                 'dbclean_expire_conversation' => 90,
182
183                 // dbclean-expire-limit (Integer)
184                 // This defines the number of items that are to be deleted in a single call.
185                 // Reduce this value when you are getting memory issues.
186                 'dbclean-expire-limit' => 1000,
187
188                 // diaspora_test (Boolean)
189                 // For development only. Disables the message transfer.
190                 'diaspora_test' => false,
191
192                 // disable_email_validation (Boolean)
193                 // Disables the check if a mail address is in a valid format and can be resolved via DNS.
194                 'disable_email_validation' => false,
195
196                 // disable_implicit_mentions (Boolean) since 2019.03
197                 // Implicit mentions are mentions in the body of replies that are redundant in a thread-enabled system like Friendica.
198                 // This config key disables the gathering of implicit mentions in incoming and outgoing posts.
199                 // Also disables the default automatic removal of implicit mentions from the body of incoming posts.
200                 // Also disables the default automatic addition of implicit mentions in the body of outgoing posts.
201                 // Disabling implicit mentions also affects the "explicit_mentions" additional feature by limiting it
202                 // to the replied-to post author mention in the comment boxes.
203                 'disable_implicit_mentions' => false,
204
205                 // disable_url_validation (Boolean)
206                 // Disables the DNS lookup of an URL.
207                 'disable_url_validation' => false,
208
209                 // disable_password_exposed (Boolean)
210                 // Disable the exposition check against the remote haveibeenpwned API on password change.
211                 'disable_password_exposed' => false,
212
213                 // disable_polling (Boolean)
214                 // Disable the polling of DFRN and OStatus contacts through onepoll.php.
215                 'disable_polling' => false,
216
217                 // display_resharer (Boolean)
218                 // Display the first resharer as icon and text on a reshared item.
219                 'display_resharer' => false,
220
221                 // dlogfile (Path)
222                 // location of the developer log file.
223                 'dlogfile' => '',
224
225                 // dlogip (String)
226                 // restricts develop log writes to requests originating from this IP address.
227                 'dlogip' => '',
228
229                 // free_crawls (Integer)
230                 // Number of "free" searches when system => permit_crawling is enabled.
231                 'free_crawls' => 10,
232
233                 // frontend_worker_timeout (Integer)
234                 // Value in minutes after we think that a frontend task was killed by the webserver.
235                 'frontend_worker_timeout' => 10,
236
237                 // groupedit_image_limit (Integer)
238                 // Number of contacts at which the group editor should switch from display the profile pictures of the contacts to only display the names.
239                 // This can alternatively be set on a per account basis in the pconfig table.
240                 'groupedit_image_limit' => 400,
241
242                 // hsts (Boolean)
243                 // Enables the sending of HTTP Strict Transport Security headers.
244                 'hsts' => false,
245
246                 // ignore_cache (Boolean)
247                 // For development only. Disables the item cache.
248                 'ignore_cache' => false,
249
250                 // insecure_imap (Boolean)
251                 // If enabled, users are allowed to connect to their IMAP servers unencrypted.
252                 // For security reasons this is disabled by default.
253                 'insecure_imap' => false,
254
255                 // instances_social_key (String)
256                 // Key to the API of https://instances.social which retrieves data about mastodon servers.
257                 // See https://instances.social/api/token to get an API key.
258                 'instances_social_key' => '',
259
260                 // ipv4_resolve (Boolean)
261                 // Resolve IPV4 addresses only. Don't resolve to IPV6.
262                 'ipv4_resolve' => false,
263
264                 // invitation_only (Boolean)
265                 // If set true registration is only possible after a current member of the node has send an invitation.
266                 'invitation_only' => false,
267
268                 // itemspage_network (Integer)
269                 // default number of items per page in stream pages (network, community, profile/contact statuses, search)
270                 'itemspage_network' => 40,
271
272                 // itemspage_network_mobile (Integer)
273                 // default number of items per page in stream pages (network, community, profile/contact statuses, search)
274                 // on detected mobile devices
275                 'itemspage_network_mobile' => 20,
276
277                 // like_no_comment (Boolean)
278                 // Don't update the "commented" value of an item when it is liked.
279                 'like_no_comment' => false,
280
281                 // local_block (Boolean)
282                 // Used in conjunction with "block_public".
283                 'local_block' => false,
284
285                 // local_search (Boolean)
286                 // Blocks search for users who are not logged in to prevent crawlers from blocking your system.
287                 'local_search' => false,
288
289                 // local_tags (Boolean)
290                 // If activated, all hashtags will point to the local server.
291                 'local_tags' => false,
292
293                 // logger_config (String)
294                 // Sets the logging adapter of Friendica globally (monolog, syslog, stream)
295                 'logger_config' => 'stream',
296
297                 // max_batch_queue (Integer)
298                 // Maximum number of batched queue items for a single contact before subsequent messages are discarded.
299                 'max_batch_queue' => 1000,
300
301                 // max_connections (Integer)
302                 // The maximum number of database connections which can be in use before the worker process is deferred to its next interval.
303                 // When the system can't detect the maximum numbers of connection then this value can be used. Use 0 for auto-detection.
304                 'max_connections' => 0,
305
306                 // max_connections_level (Integer 0-100)
307                 // The maximum percentage of connections that are allowed to let the worker start.
308                 'max_connections_level' => 75,
309
310                 // max_contact_queue (Integer)
311                 // Maximum number of queue items for a single contact before subsequent messages are discarded.
312                 'max_contact_queue' => 500,
313
314                 // max_csv_file_size (Integer)
315                 // When uploading a CSV with account addresses to follow
316                 // in the user settings, this controls the maximum file
317                 // size of the upload file.
318                 'max_csv_file_size' => 30720,
319
320                 // max_feed_items (Integer)
321                 // Maximum number of feed items that are fetched and processed. For unlimited items set to 0.
322                 'max_feed_items' => 20,
323
324                 // max_image_length (Integer)
325                 // An alternate way of limiting picture upload sizes.
326                 // Specify the maximum pixel  length that pictures are allowed to be (for non-square pictures, it will apply to the longest side).
327                 // Pictures longer than this length will be resized to be this length (on the longest side, the other side will be scaled appropriately).
328                 // If you don't want to set a maximum length, set to -1.
329                 'max_image_length' => -1,
330
331                 // max_processes_backend (Integer)
332                 // Maximum number of concurrent database processes for background tasks.
333                 'max_processes_backend' => 5,
334
335                 // max_processes_frontend (Integer)
336                 // Maximum number of concurrent database processes for foreground tasks.
337                 'max_processes_frontend' => 20,
338
339                 // maximagesize (Integer)
340                 // Maximum size in bytes of an uploaded photo.
341                 'maximagesize' => 800000,
342
343                 // memcache_host (String)
344                 // Host name of the memcache daemon.
345                 'memcache_host' => '127.0.0.1',
346
347                 // memcache_port (Integer)
348                 // Port number of the memcache daemon.
349                 'memcache_port' => 11211,
350
351                 // memcached_hosts (Array)
352                 // Array of Memcached servers info [host, port(, weight)], see Memcached::addServers.
353                 'memcached_hosts' => [
354                         ['127.0.0.1', '11211'],
355                 ],
356
357                 // min_poll_interval (Integer)
358                 // minimal distance in minutes between two polls for a contact. Reasonable values are between 1 and 59.
359                 'min_poll_interval' => 15,
360
361                 // no_count (Boolean)
362                 // Don't do count calculations (currently only when showing photo albums).
363                 'no_count' => false,
364
365                 // no_oembed (Boolean)
366                 // Don't use OEmbed to fetch more information about a link.
367                 'no_oembed' => false,
368
369                 // no_redirect_list (Array)
370                 // List of domains where HTTP redirects should be ignored. 
371                 'no_redirect_list' => [],
372
373                 // no_smilies (Boolean)
374                 // Don't show smilies.
375                 'no_smilies' => false,
376
377                 // optimize_items (Boolean)
378                 // Triggers an SQL command to optimize the item table before expiring items.
379                 'optimize_items' => false,
380
381                 // paranoia (Boolean)
382                 // Log out users if their IP address changed.
383                 'paranoia' => false,
384
385                 // permit_crawling (Boolean)
386                 // Restricts the search for not logged in users to one search per minute.
387                 'permit_crawling' => false,
388
389                 // pidfile (Path)
390                 // Daemon pid file path. For example: pidfile = /path/to/daemon.pid
391                 'pidfile' => '',
392
393                 // png_quality (Integer)
394                 // Sets the ImageMagick compression level for PNG images. Values ranges from 0 (uncompressed) to 9 (most compressed).
395                 'png_quality' => 8,
396
397                 // profiler (Boolean)
398                 // Enable internal timings to help optimize code. Needed for "rendertime" addon.
399                 'profiler' => false,
400
401                 // proxy_cache_time (Integer)
402                 // Period in seconds after which the cache is cleared.
403                 'proxy_cache_time' => 86400,
404
405                 // pushpoll_frequency (Integer)
406                 // Frequency of contact poll for subhub contact using the DFRM or OStatus network.
407                 // Available values:
408                 // - 5 = every month
409                 // - 4 = every week
410                 // - 3 = every day
411                 // - 2 = twice a day
412                 // - 1 = every hour
413                 // - 0 = every minute
414                 'pushpoll_frequency' => 3,
415
416                 // redis_host (String)
417                 // Host name of the redis daemon.
418                 'redis_host' => '127.0.0.1',
419
420                 // redis_port (String)
421                 // Port number of the redis daemon.
422                 'redis_port' => 6379,
423
424                 // redis_db (Integer)
425                 // The sub-database of redis (0 - 15 possible sub-databases)
426                 'redis_db' => 0,
427
428                 // redis_password (String)
429                 // The authentication password for the redis database
430                 'redis_password' => null,
431
432                 // session_handler (database|cache|native)
433                 // Whether to use Cache to store session data or to use PHP native session storage.
434                 'session_handler' => 'database',
435
436                 // remove_multiplicated_lines (Boolean)
437                 // If enabled, multiple linefeeds in items are stripped to a single one.
438                 'remove_multiplicated_lines' => false,
439
440                 // sendmail_params (Boolean)
441                 // Normal sendmail command parameters will be added when the PHP mail() function is called for sending e-mails.
442                 // This ensures the Sender Email address setting is applied to the message envelope rather than the host's default address.
443                 // Set to false if your non-sendmail agent is incompatible, or to restore old behavior of using the host address.
444                 'sendmail_params' => true,
445
446                 // show_global_community_hint (Boolean)
447                 // When the global community page is enabled, use this option to display a hint above the stream, that this is a collection of all public top-level postings that arrive on your node.
448                 'show_global_community_hint' => false,
449
450                 // show_received (Boolean)
451                 // Show the receive data along with the post creation date
452                 'show_received' => true,
453
454                 // show_received_seconds (Integer)
455                 // Display the received date when the difference between received and created is higher than this.
456                 'show_received_seconds' => 500,
457
458                 // show_unsupported_addons (Boolean)
459                 // Show all addons including the unsupported ones.
460                 'show_unsupported_addons' => false,
461
462                 // show_unsupported_themes (Boolean)
463                 // Show all themes including the unsupported ones.
464                 'show_unsupported_themes' => false,
465
466                 // throttle_limit_day (Integer)
467                 // Maximum number of posts that a user can send per day with the API. 0 to disable daily throttling.
468                 'throttle_limit_day' => 0,
469
470                 // throttle_limit_week (Integer)
471                 // Maximum number of posts that a user can send per week with the API. 0 to disable weekly throttling.
472                 'throttle_limit_week' => 0,
473
474                 // throttle_limit_month (Integer)
475                 // Maximum number of posts that a user can send per month with the API. 0 to disable monthly throttling.
476                 'throttle_limit_month' => 0,
477
478                 // update_active_contacts (Boolean)
479                 // When activated, only public contacts will be activated regularly that are used for example in items or tags.
480                 'update_active_contacts' => false,
481
482                 // username_min_length (Integer)
483                 // The minimum character length a username can be.
484                 // This length is check once the username has been trimmed and multiple spaces have been collapsed into one.
485                 // Minimum for this config value is 1. Maximum is 64 as the resulting profile URL mustn't be longer than 255 chars.
486                 'username_min_length' => 3,
487
488                 // username_max_length (Integer)
489                 // The maximum character length a username can be.
490                 // This length is check once the username has been trimmed and multiple spaces have been collapsed into one.
491                 // Minimum for this config value is 1. Maximum is 64 as the resulting profile URL mustn't be longer than 255 chars.
492                 'username_max_length' => 48,
493
494                 // worker_cooldown (Integer)
495                 // Cooldown period in seconds after each worker function call.
496                 'worker_cooldown' => 0,
497
498                 // worker_debug (Boolean)
499                 // If enabled, it prints out the number of running processes split by priority.
500                 'worker_debug' => false,
501
502                 // worker_fetch_limit (Integer)
503                 // Number of worker tasks that are fetched in a single query.
504                 'worker_fetch_limit' => 1,
505
506                 // worker_jpm (Boolean)
507                 // If enabled, it prints out the jobs per minute.
508                 'worker_jpm' => false,
509
510                 // worker_jpm_range (String)
511                 // List of minutes for the jobs per minute (JPM) calculation
512                 'worker_jpm_range' => '1, 10, 60',
513
514                 // worker_load_exponent (Integer)
515                 // Default 3, which allows only 25% of the maximum worker queues when server load reaches around 37% of maximum load.
516                 // For a linear response where 25% of worker queues are allowed at 75% of maximum load, set this to 1.
517                 // Setting 0 would allow maximum worker queues at all times, which is not recommended.
518                 'worker_load_exponent' => 3,
519
520                 // worker_multiple_fetch (Boolean)
521                 // When activated, the worker fetches jobs for multiple workers (not only for itself).
522                 // This is an experimental setting without knowing the performance impact.
523                 'worker_multiple_fetch' => false,
524                 
525                 // worker_defer_limit (Integer)
526                 // Per default the systems tries delivering for 15 times before dropping it.
527                 'worker_defer_limit' => 15,
528
529                 // xrd_timeout (Integer)
530                 // Timeout in seconds for fetching the XRD links.
531                 'xrd_timeout' => 20,
532         ],
533         'experimental' => [
534                 // exp_themes (Boolean)
535                 // Show experimental themes in user settings.
536                 'exp_themes' => false,
537         ],
538         'theme' => [
539                 // hide_eventlist (Boolean)
540                 // Don't show the birthdays and events on the profile and network page.
541                 'hide_eventlist' => false,
542         ],
543         'jabber' => [
544                 // debug (Boolean)
545                 // Enable debug level for the jabber account synchronisation.
546                 'debug' => false,
547                 // lockpath (Path)
548                 // Must be writable by the ejabberd process. if set then it will prevent the running of multiple processes.
549                 'lockpath' => '',
550         ],
551         'debug' => [
552                 // ap_inbox_log (Boolean)
553                 // Logs every call to /inbox as a JSON file in Friendica's temporary directory
554                 'ap_inbox_log' => false,
555
556                 // show_direction (Boolean)
557                 // Display if a post had been fetched or had been pushed towards our server
558                 'show_direction' => false,
559
560                 // total_ap_delivery (Boolean)
561                 // Deliver via AP to every possible receiver and we suppress the delivery to these contacts with other protocols
562                 'total_ap_delivery' => false,
563         ]
564 ];