3 * @copyright Copyright (C) 2020, Friendica
5 * @license GNU AGPL version 3 or any later version
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.
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.
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/>.
20 * This file declares the default values for the base config of Friendica.
22 * These configuration values aren't accessible from the admin settings page and custom values must be set in config/local.config.php
24 * Please don't edit this file directly as its content may change in the upcoming versions.
31 // Hostname or IP address of the database server.
32 // Can contain the port number with the syntax "hostname:port".
36 // Database user name. Please don't use "root".
40 // Database user password. Please don't use empty passwords.
48 // Database connection charset. Changing this value will likely corrupt special characters.
49 'charset' => 'utf8mb4',
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,
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,
62 // disable_pdo (Boolean)
63 // PDO is used by default (if available). Otherwise MySQLi will be used.
64 'disable_pdo' => false,
67 // admin_email (Comma-separated list)
68 // In order to perform system administration via the admin panel,
69 // this must precisely match the email address of the person logged in.
72 // admin_nickname (String)
73 // Nickname of the main admin user, used if there are more than one admin user defined in config => admin_email.
74 'admin_nickname' => '',
76 // max_import_size (Integer)
77 // Maximum body size of DFRN and Mail messages in characters. 0 is unlimited.
78 'max_import_size' => 200000,
81 // Location of PHP command line processor.
85 // adjust_poll_frequency (Boolean)
86 // Automatically detect and set the best feed poll frequency.
87 'adjust_poll_frequency' => false,
89 // allowed_link_protocols (Array)
90 // Allowed protocols in links URLs, add at your own risk. http(s) is always allowed.
91 'allowed_link_protocols' => ['ftp://', 'ftps://', 'mailto:', 'cid:', 'gopher://'],
93 // always_show_preview (Boolean)
94 // Only show small preview pictures.
95 'always_show_preview' => false,
97 // ap_always_bcc (Boolean)
98 // Adresses non-mentioned ActivityPub receivers by BCC instead of CC. Increases privacy, decreases performance.
99 'ap_always_bcc' => false,
101 // archival_days (Integer)
102 // Number of days that we try to deliver content before we archive a contact.
103 'archival_days' => 32,
105 // auth_cookie_lifetime (Integer)
106 // Number of days that should pass without any activity before a user who
107 // chose "Remember me" when logging in is considered logged out.
108 'auth_cookie_lifetime' => 7,
110 // big_emojis (Boolean)
111 // Display "Emoji Only" posts in big.
112 'big_emojis' => false,
114 // block_local_dir (Boolean)
115 // Deny public access to the local user directory.
116 'block_local_dir' => false,
118 // cron_interval (Integer)
119 // Minimal period in minutes between two calls of the "Cron" worker job.
120 'cron_interval' => 5,
122 // cache_driver (database|memcache|memcached|redis)
123 // Whether to use Memcache or Memcached or Redis to store temporary cache.
124 'cache_driver' => 'database',
126 // config_adapter (jit|preload)
127 // Allow to switch the configuration adapter to improve performances at the cost of memory consumption.
128 'config_adapter' => 'jit',
130 // curl_range_bytes (Integer)
131 // Maximum number of bytes that should be fetched. Default is 0, which mean "no limit".
132 'curl_range_bytes' => 0,
134 // crawl_permit_period (Integer)
135 // Period in seconds between allowed searches when the number of free searches is reached and "permit_crawling" is activated.
136 'crawl_permit_period' => 60,
139 // Name of a logfile to log slow database queries.
142 // db_log_index (Path)
143 // Name of a logfile to log queries with bad indexes.
144 'db_log_index' => '',
146 // db_log_index_watch (Comma-separated list)
147 // Watchlist of indexes to watch.
148 'db_log_index_watch' => '',
150 // db_log_index_denylist (Comma-separated list)
151 // Deny list of indexes that shouldn't be watched.
152 'db_log_index_denylist' => '',
154 // db_loglimit (Integer)
155 // If a database call lasts longer than this value in seconds it is logged.
156 // Inactive if system => db_log is empty.
159 // db_loglimit_index (Integer)
160 // Number of index rows needed to be logged for indexes on the watchlist. 0 to disable.
161 'db_loglimit_index' => 0,
163 // db_loglimit_index_high (Integer)
164 // Number of index rows to be logged anyway (for any index). 0 to disable.
165 'db_loglimit_index_high' => 0,
167 // dbclean_expire_conversation (Integer)
168 // When DBClean is enabled, any entry in the conversation table will be deleted after this many days.
169 // This data is used for ActivityPub, so it shouldn't be lower than the average duration of a discussion.
170 'dbclean_expire_conversation' => 90,
172 // dbclean-expire-limit (Integer)
173 // This defines the number of items that are to be deleted in a single call.
174 // Reduce this value when you are getting memory issues.
175 'dbclean-expire-limit' => 1000,
177 // diaspora_test (Boolean)
178 // For development only. Disables the message transfer.
179 'diaspora_test' => false,
181 // disable_email_validation (Boolean)
182 // Disables the check if a mail address is in a valid format and can be resolved via DNS.
183 'disable_email_validation' => false,
185 // disable_implicit_mentions (Boolean) since 2019.03
186 // Implicit mentions are mentions in the body of replies that are redundant in a thread-enabled system like Friendica.
187 // This config key disables the gathering of implicit mentions in incoming and outgoing posts.
188 // Also disables the default automatic removal of implicit mentions from the body of incoming posts.
189 // Also disables the default automatic addition of implicit mentions in the body of outgoing posts.
190 // Disabling implicit mentions also affects the "explicit_mentions" additional feature by limiting it
191 // to the replied-to post author mention in the comment boxes.
192 'disable_implicit_mentions' => false,
194 // disable_url_validation (Boolean)
195 // Disables the DNS lookup of an URL.
196 'disable_url_validation' => false,
198 // disable_password_exposed (Boolean)
199 // Disable the exposition check against the remote haveibeenpwned API on password change.
200 'disable_password_exposed' => false,
202 // disable_polling (Boolean)
203 // Disable the polling of DFRN and OStatus contacts through onepoll.php.
204 'disable_polling' => false,
207 // location of the developer log file.
211 // restricts develop log writes to requests originating from this IP address.
214 // free_crawls (Integer)
215 // Number of "free" searches when system => permit_crawling is enabled.
218 // frontend_worker_timeout (Integer)
219 // Value in minutes after we think that a frontend task was killed by the webserver.
220 'frontend_worker_timeout' => 10,
222 // groupedit_image_limit (Integer)
223 // Number of contacts at which the group editor should switch from display the profile pictures of the contacts to only display the names.
224 // This can alternatively be set on a per account basis in the pconfig table.
225 'groupedit_image_limit' => 400,
228 // Enables the sending of HTTP Strict Transport Security headers.
231 // ignore_cache (Boolean)
232 // For development only. Disables the item cache.
233 'ignore_cache' => false,
235 // insecure_imap (Boolean)
236 // If enabled, users are allowed to connect to their IMAP servers unencrypted.
237 // For security reasons this is disabled by default.
238 'insecure_imap' => false,
240 // instances_social_key (String)
241 // Key to the API of https://instances.social which retrieves data about mastodon servers.
242 // See https://instances.social/api/token to get an API key.
243 'instances_social_key' => '',
245 // ipv4_resolve (Boolean)
246 // Resolve IPV4 addresses only. Don't resolve to IPV6.
247 'ipv4_resolve' => false,
249 // invitation_only (Boolean)
250 // If set true registration is only possible after a current member of the node has send an invitation.
251 'invitation_only' => false,
253 // itemspage_network (Integer)
254 // default number of items per page in stream pages (network, community, profile/contact statuses, search)
255 'itemspage_network' => 40,
257 // itemspage_network_mobile (Integer)
258 // default number of items per page in stream pages (network, community, profile/contact statuses, search)
259 // on detected mobile devices
260 'itemspage_network_mobile' => 20,
262 // like_no_comment (Boolean)
263 // Don't update the "commented" value of an item when it is liked.
264 'like_no_comment' => false,
266 // local_block (Boolean)
267 // Used in conjunction with "block_public".
268 'local_block' => false,
270 // local_search (Boolean)
271 // Blocks search for users who are not logged in to prevent crawlers from blocking your system.
272 'local_search' => false,
274 // local_tags (Boolean)
275 // If activated, all hashtags will point to the local server.
276 'local_tags' => false,
278 // logger_config (String)
279 // Sets the logging adapter of Friendica globally (monolog, syslog, stream)
280 'logger_config' => 'stream',
282 // max_batch_queue (Integer)
283 // Maximum number of batched queue items for a single contact before subsequent messages are discarded.
284 'max_batch_queue' => 1000,
286 // max_connections (Integer)
287 // The maximum number of database connections which can be in use before the worker process is deferred to its next interval.
288 // When the system can't detect the maximum numbers of connection then this value can be used. Use 0 for auto-detection.
289 'max_connections' => 0,
291 // max_connections_level (Integer 0-100)
292 // The maximum percentage of connections that are allowed to let the worker start.
293 'max_connections_level' => 75,
295 // max_contact_queue (Integer)
296 // Maximum number of queue items for a single contact before subsequent messages are discarded.
297 'max_contact_queue' => 500,
299 // max_feed_items (Integer)
300 // Maximum number of feed items that are fetched and processed. For unlimited items set to 0.
301 'max_feed_items' => 20,
303 // max_image_length (Integer)
304 // An alternate way of limiting picture upload sizes.
305 // Specify the maximum pixel length that pictures are allowed to be (for non-square pictures, it will apply to the longest side).
306 // Pictures longer than this length will be resized to be this length (on the longest side, the other side will be scaled appropriately).
307 // If you don't want to set a maximum length, set to -1.
308 'max_image_length' => -1,
310 // max_processes_backend (Integer)
311 // Maximum number of concurrent database processes for background tasks.
312 'max_processes_backend' => 5,
314 // max_processes_frontend (Integer)
315 // Maximum number of concurrent database processes for foreground tasks.
316 'max_processes_frontend' => 20,
318 // maximagesize (Integer)
319 // Maximum size in bytes of an uploaded photo.
320 'maximagesize' => 800000,
322 // memcache_host (String)
323 // Host name of the memcache daemon.
324 'memcache_host' => '127.0.0.1',
326 // memcache_port (Integer)
327 // Port number of the memcache daemon.
328 'memcache_port' => 11211,
330 // memcached_hosts (Array)
331 // Array of Memcached servers info [host, port(, weight)], see Memcached::addServers.
332 'memcached_hosts' => [
333 ['127.0.0.1', '11211'],
336 // min_poll_interval (Integer)
337 // minimal distance in minutes between two polls for a contact. Reasonable values are between 1 and 59.
338 'min_poll_interval' => 15,
340 // no_count (Boolean)
341 // Don't do count calculations (currently only when showing photo albums).
344 // no_oembed (Boolean)
345 // Don't use OEmbed to fetch more information about a link.
346 'no_oembed' => false,
348 // no_smilies (Boolean)
349 // Don't show smilies.
350 'no_smilies' => false,
352 // optimize_items (Boolean)
353 // Triggers an SQL command to optimize the item table before expiring items.
354 'optimize_items' => false,
356 // paranoia (Boolean)
357 // Log out users if their IP address changed.
360 // permit_crawling (Boolean)
361 // Restricts the search for not logged in users to one search per minute.
362 'permit_crawling' => false,
365 // Daemon pid file path. For example: pidfile = /path/to/daemon.pid
368 // png_quality (Integer)
369 // Sets the ImageMagick compression level for PNG images. Values ranges from 0 (uncompressed) to 9 (most compressed).
372 // profiler (Boolean)
373 // Enable internal timings to help optimize code. Needed for "rendertime" addon.
376 // proxy_cache_time (Integer)
377 // Period in seconds after which the cache is cleared.
378 'proxy_cache_time' => 86400,
380 // pushpoll_frequency (Integer)
381 // Frequency of contact poll for subhub contact using the DFRM or OStatus network.
388 // - 0 = every minute
389 'pushpoll_frequency' => 3,
391 // queue_no_dead_check (Boolean)
392 // Ignore if the target contact or server seems to be dead during queue delivery.
393 'queue_no_dead_check' => false,
395 // redis_host (String)
396 // Host name of the redis daemon.
397 'redis_host' => '127.0.0.1',
399 // redis_port (String)
400 // Port number of the redis daemon.
401 'redis_port' => 6379,
403 // redis_db (Integer)
404 // The sub-database of redis (0 - 15 possible sub-databases)
407 // redis_password (String)
408 // The authentication password for the redis database
409 'redis_password' => null,
411 // session_handler (database|cache|native)
412 // Whether to use Cache to store session data or to use PHP native session storage.
413 'session_handler' => 'database',
415 // remove_multiplicated_lines (Boolean)
416 // If enabled, multiple linefeeds in items are stripped to a single one.
417 'remove_multiplicated_lines' => false,
419 // sendmail_params (Boolean)
420 // Normal sendmail command parameters will be added when the PHP mail() function is called for sending e-mails.
421 // This ensures the Sender Email address setting is applied to the message envelope rather than the host's default address.
422 // Set to false if your non-sendmail agent is incompatible, or to restore old behavior of using the host address.
423 'sendmail_params' => true,
425 // show_global_community_hint (Boolean)
426 // 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.
427 'show_global_community_hint' => false,
429 // show_received (Boolean)
430 // Show the receive data along with the post creation date
431 'show_received' => true,
433 // show_received_seconds (Integer)
434 // Display the received date when the difference between received and created is higher than this.
435 'show_received_seconds' => 500,
437 // show_unsupported_addons (Boolean)
438 // Show all addons including the unsupported ones.
439 'show_unsupported_addons' => false,
441 // show_unsupported_themes (Boolean)
442 // Show all themes including the unsupported ones.
443 'show_unsupported_themes' => false,
445 // throttle_limit_day (Integer)
446 // Maximum number of posts that a user can send per day with the API. 0 to disable daily throttling.
447 'throttle_limit_day' => 0,
449 // throttle_limit_week (Integer)
450 // Maximum number of posts that a user can send per week with the API. 0 to disable weekly throttling.
451 'throttle_limit_week' => 0,
453 // throttle_limit_month (Integer)
454 // Maximum number of posts that a user can send per month with the API. 0 to disable monthly throttling.
455 'throttle_limit_month' => 0,
457 // username_min_length (Integer)
458 // The minimum character length a username can be.
459 // This length is check once the username has been trimmed and multiple spaces have been collapsed into one.
460 // Minimum for this config value is 1. Maximum is 64 as the resulting profile URL mustn't be longer than 255 chars.
461 'username_min_length' => 3,
463 // username_max_length (Integer)
464 // The maximum character length a username can be.
465 // This length is check once the username has been trimmed and multiple spaces have been collapsed into one.
466 // Minimum for this config value is 1. Maximum is 64 as the resulting profile URL mustn't be longer than 255 chars.
467 'username_max_length' => 48,
469 // worker_cooldown (Integer)
470 // Cooldown period in seconds after each worker function call.
471 'worker_cooldown' => 0,
473 // worker_debug (Boolean)
474 // If enabled, it prints out the number of running processes split by priority.
475 'worker_debug' => false,
477 // worker_fetch_limit (Integer)
478 // Number of worker tasks that are fetched in a single query.
479 'worker_fetch_limit' => 1,
481 // worker_jpm (Boolean)
482 // If enabled, it prints out the jobs per minute.
483 'worker_jpm' => false,
485 // worker_jpm_range (String)
486 // List of minutes for the jobs per minute (JPM) calculation
487 'worker_jpm_range' => '1, 10, 60',
489 // worker_load_exponent (Integer)
490 // Default 3, which allows only 25% of the maximum worker queues when server load reaches around 37% of maximum load.
491 // For a linear response where 25% of worker queues are allowed at 75% of maximum load, set this to 1.
492 // Setting 0 would allow maximum worker queues at all times, which is not recommended.
493 'worker_load_exponent' => 3,
495 // worker_defer_limit (Integer)
496 // Per default the systems tries delivering for 15 times before dropping it.
497 'worker_defer_limit' => 15,
499 // xrd_timeout (Integer)
500 // Timeout in seconds for fetching the XRD links.
504 // exp_themes (Boolean)
505 // Show experimental themes in user settings.
506 'exp_themes' => false,
509 // hide_eventlist (Boolean)
510 // Don't show the birthdays and events on the profile and network page.
511 'hide_eventlist' => false,
515 // Enable debug level for the jabber account synchronisation.
518 // Must be writable by the ejabberd process. if set then it will prevent the running of multiple processes.
522 // ap_inbox_log (Boolean)
523 // Logs every call to /inbox as a JSON file in Friendica's temporary directory
524 'ap_inbox_log' => false,
526 // show_direction (Boolean)
527 // Display if a post had been fetched or had been pushed towards our server
528 'show_direction' => false,
530 // total_ap_delivery (Boolean)
531 // Deliver via AP to every possible receiver and we suppress the delivery to these contacts with other protocols
532 'total_ap_delivery' => false,