1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
### Advanced configurations for administrators
*This document assumes that you are an administrator.*
Hubzilla contains many configuration options that are hidden in the main administration area. Generally, these are options that are considered too niche, advanced, or confusing.
These settings can be changed via the shell from the top level web directory using the following syntax
`util/config cat key value`
for a website configuration, or
`util/pconfig channel_id cat key value`
for a member configuration.
For a site configuration, another option is to insert a line in .htconfig.php with the syntax:
App::$config[‘cat’][‘key’] = ‘value’;`
#### Member configuration (pconfig)
- system.always_my_theme
Always use your own theme when watching channels in the same hub. This leads to some pretty imaginative problems when viewing channels with themed comanches.
- system.blocked
An array of Xchans that are blocked by this channel. Technically this is a hidden configuration and belongs here, but addons (notably Superblock) have made this available in the UI.
- system.default_cipher
Sets the default cipher used for E2EE elements.
- system.display_friend_count
Defines the number of connections to be displayed in the connection profile widget.
- system.do_not_track
Like the browser header. This will break many identity-based functions. You should really only set permissions that make sense.
- system.forcepublicuploads
Forces uploaded photos to be public when uploaded as wall elements. It makes much more sense to set the permissions correctly in the first place. Do this instead.
- system.network_page_default
Sets the default parameters for displaying the network page. This should contain the same query string as the manual filtering.
- system.paranoia
Defines the security level of the IP check. If the IP address of a logged on session changes, this level is applied to determine if the account should be logged off as a security breach. The options are: 0 - no IP check 1 - check 3 octets 2 - check 2 octets 3 - check for all differences
- system.prevent_tag_hijacking
Prevents external networks from hijacking hashtags in your posts and redirecting them to their own resources.
- system.startpage
Another one of those technically hidden configurations provided by addons. Defines the default page that is displayed when you log in. This is made available to the user interface by the startpage add-on.
- system.taganyone
Requires that the configuration of the same name is activated. Allows @mention tagging of everyone, regardless of whether you are connected or not. This does not scale.
- system.anonymous_comments
By default or if set to 1, custom permissions can be set to allow anonymous (moderated) comments like WordPress, moderated by the channel owner. If set to 0, no member of your site can select or enable this.
- system.user_scalable
Determines whether the app is scalable to touchscreens. Set to on by default, set to zero to deactivate - real zero, not just false.
#### Configuration of the website
- randprofile.check
When requesting a random profile, first check whether it actually exists
- randprofile.retry
Number of attempts to obtain a random profile
- system.admin_email
Specifies the e-mail address of the administrator for this site. This is defined during installation.
- system.authlog
Log file used for logging authentication errors. Used to connect to server-side software such as fail2ban. Auth errors are also logged in the main logs.
- system.auto_channel_create
Adds the necessary form elements to create the first channel on the account registration page and creates it (possibly after email validation or administrator approval). This excludes the ability to import a channel from another site as the first channel created on this site for a new account. Use with system.default_permissions_role to streamline registration.
- system.auto_follow
The first channel of an account automatically follows the channels listed here - comma separated list of webbies (member@hub addresses).
- system.blacklisted_sites
An array of specific hubs that are to be completely blocked by this hub.
- system.block_public_search
Similar to block_public, with the difference that only public access to the search functions is blocked. Useful for pages that want to be public but are overrun by search engines.
- system.cron_hour
Specify an hour in which cron_daily should be executed. By default, without configuration, this is executed at midnight UTC.
- system.default_permissions_role
If this value is set to a valid name for a permission role, this role will be used for the first channel created by a new account and will not prompt for the ‘channel type’ on the channel creation form. Examples of valid names are: ‘social’, ‘social_restricted’, ‘social_private’, ‘forum’, ‘forum_restricted’ and ‘forum_private’. Read more about authorisation roles [here](https://hub.hubzilla.hu/help/roles).
- system.default_profile_photo
Defines the profile photo with which new channels start. This should contain the name of a directory located under images/default_profile_photos/ or it should not be set. If it is not set, ‘rainbow_man’ is assumed.
- system.directorytags
Specifies the number of keyword tags to display on the directory page. The default is 50 if it is not set to a positive integer.
- system.disable_directory_keywords
If ‘1’, no directory keywords are displayed. If the hub is a directory server, prevent keywords from being returned to all directory clients. Please do not set this for directory servers in the RED_GLOBAL area.
- system.disable_discover_tab
Allows you to completely disable the ability to discover public content from external sites.
- system.disable_dreport
If ‘1’, no delivery reports are saved or linked.
- system.dlogfile
Log file used for logging development errors. Exactly the same as logger otherwise. This is not magic and requires your own logging instructions. Developer tool.
- system.email_notify_icon_url
URL of the image (32x32) to be displayed in email notifications (HTML bodies).
- system.expire_delivery_reports
Expiry date in days for delivery reports - default value 10
- system.expire_limit
Do not expire more than this number of reports per channel per expiry run to avoid exhausting the memory. Default value 5000.
- system.photo_storage_type
If ‘1’, the file system is used instead of the SQL database to store the thumbnails. Default setting is ‘0’. Introduced in 4.2
- system.hidden_version_siteinfo
If ‘true’, the software version is not displayed on the siteinfo pages (system.hide_version hides the version on these pages as well, this setting *only* hides the version on the siteinfo pages).
- system.hide_help
Do not show the link to the help documentation in the navigation bar
- system.hide_in_statistics
Instructs the red statistics servers to completely hide this hub in hub lists.
- system.hide_version
If true, the software version is not displayed on websites and tools. (*) Must be set in .htconfig.php.
- system.ignore_imagick
Ignores imagick and uses GD, even if imagick is installed on the server. Prevents some problems with PNG files in older versions of imagick.
- system.max_daily_registrations
Defines the maximum number of new registrations allowed in a day. Useful to prevent oversubscription when publicising the project.
- system.max_import_size
If configured, the maximum length of an imported text message. This is usually left at 200 KBytes or more to accommodate private Friendica photos that are embedded.
- system.max_tagged_forums
Spam protection. Limits the number of tagged forums recognised in each post. Default is 2, only the first ‘n’ tags are delivered as forums, the others cause no delivery.
- system.minimum_feedcheck_minutes
The minimum interval between checking RSS feeds. If this interval is less than the cron interval, the feeds are checked with every cron job. The default value is 60 if it has not been set. The site setting can also be overridden for each individual channel by a service class setting aptly named ‘minimum_feedcheck_minutes’.
- system.no_age_restriction
Do not restrict registration to persons over the age of 13. In many countries it is required by law that age must be specified and that all personal data of minors must be blocked.
- system.object_cache_days
Defines how long cached embedded content can be used without being retrieved again. The default setting is 30 days.
- system.openssl_conf_file
Specify a file that contains the OpenSSL configuration. Required in some Windows installations to find the openssl configuration file on the system. Read the code first. If you cannot read the code, do not play with it.
- system.openssl_encrypt
Use encryption engine from openssl, default is false (uses mcrypt for AES encryption)
- system.optimize_items
Executes optimise_table during some tasks to keep your database clean and defragmented. This comes at the expense of performance while the operations are running, but also makes things run a bit faster when they are not. There are also CLI utilities to perform this operation that you may prefer, especially if you have a large site.
- system.override_poll_lockfile
Ignores the lock file in the poller process to allow more than one process to run at a time.
- system.paranoia
Like pconfig, but on a site-wide basis. Can be overridden by member settings.
- system.pin_types
Array of allowed element types for pinning. The default values depend on the module, but can be changed here.
- system.photo_cache_time
How long the photos should be cached, in seconds. The default value is 86400 (1 day). A longer time increases performance, but also means that it takes longer for changed authorisations to apply.
- system.platform_name
What should be displayed as the platform name on websites and in statistics. (*) Must be set in .htconfig.php.
- system.rating_enabled
Distributed reputation reports and data collection. This function is currently being revised.
- system.poke_basic
Reduce the number of poke verbs to exactly 1 (‘poke’). Deactivate other verbs.
- system.proc_run_use_exec
If 1, the system call exec in proc_run is used to execute background tasks. By default we use proc_open and proc_close. On some (currently rare) systems this does not work well.
- system.projecthome
Displays the project page on your homepage for logged out viewers.
- system.projecthome
Defines the project home page as the start page of the hub. (Obsolete)
- system.pubstream_order
Defines the pubstream order. Possible values ‘commented’ (default), ‘created’ and ‘edited’.
- system.register_link
Path to which the ‘register’ link in the registration form should point. For closed sites, this will point to ‘pubsites’. For open sites, it will normally redirect to ‘register’, but you can change this to a custom site page that offers subscriptions or similar.
- system.reserved_channels
Do not allow members to register channels with this comma-separated list of names (no spaces).
- system.sellpage
A URL to display in the list of public sites to sell your hub - show classes of service, etc.
- system.startpage
Defines the default page that is displayed for all channels on this website after a login. Can be overridden by user settings.
- system.sys_expire_days
How many days should discovered public content from other websites be kept?
- system.taganyone
Allows @mention tagging of everyone, whether you are connected or not.
- system.tempdir
Location where temporary files are stored (currently unused), default is defined in PHP configuration.
- system.tos_url
Sets an alternative link for the ToS storage location.
- system.transport_security_header
if non-zero and SSL is used, a strict-transport-security header is inserted on the web pages
- system.uploaddir
Storage location for uploading files (default is system.tempdir, currently only used by the js_upload plugin)
- system.workflow_channel_next
The page to which new members should be redirected immediately after creating a channel.
- system.workflow_register_next
The page to which members are redirected immediately after creating an account (only if auto_channel_create or UNO is activated).
#### Directory configuration
##### Default values for the directory search
- directory.globaldir
0 or 1. default value 0. If you visit the directory on a site, you will only see the members of this site by default. You have to take an extra step to see the people in the rest of the network; and by doing this, there is a clear delineation that these people are *not* members of this site, but of a larger network.
- directory.pubforums
0 or 1. public forums *should* be 0 by default.
- directory.safemode
0 or 1.
##### Configuration of the directory server
- system.directory_mode
- system.directory_primary
- system.directory_realm
- system.directory_server
- system.realm_token
|
