Redmatrix contains many configuration options hidden from the main admin panel.
These are generally options considered too niche, confusing, or advanced for
the average member. These settings can be activated from the the top level Red
directory with the syntax
util/config cat key value
for a siteconfiguration, or
util/pconfig channel_id cat key value
for a member configuration.
This document assumes you're an administrator.
pconfig
system > user_scalable
Determine if the app is scalable on touch screens. Defaults to on, to
disable, set to zero - real zero, not just false.
system > always_my_theme
Always use your own theme when viewing channels on the same hub. This
will break in some quite imaginative ways when viewing channels with
theme dependent Comanche.
system > paranoia
Sets the security level of IP checking. If the IP address of a logged-in session changes
apply this level to determine if the account should be logged out as a security breach.
Options are:
0 - no IP checking
1 - check 3 octets
2 - check 2 octets
3 - check for any difference at all
system > prevent_tag_hijacking
Prevent foreign networks hijacking hashtags in your posts and directing them at its own resources.
system > blocked
An array of xchans blocked by this channel. Technically, this is a
hidden config and does belong here, however, addons (notably
superblock) have made this available in the UI.
system > default_cipher
Set the default cipher used for E2EE items.
system > network_page_default
Set default params when viewing the network page. This should contain
the same querystring as manual filtering.
system > display_friend_count
Set the number of connections to display in the connections profile
widget.
system > taganyone
Requires the config of the same name to be enabled. Allow the @mention tagging
of anyone, whether you are connected or not. This doesn't scale.
system > startpage
Another of those technically hidden configs made available by addons.
Sets the default page to view when logging in. This is exposed to the
UI by the startpage addon.
system > forcepublicuploads
Force uploaded photos to be public when uploaded as wall items. It
makes far more sense to just set your permissions properly in the first
place. Do that instead.
system > do_not_track
As the browser header. This will break many identity based features.
You should really just set permissions that make sense.
Site config
system > taganyone
Allow the @mention tagging of anyone whether you are connected or not.
system > directorytags
Set the number of keyword tags displayed on the directory page.
system > startpage
Set the default page to be taken to after a login for all channels at
this website. Can be overwritten by user settings.
system > projecthome
Set the project homepage as the homepage of your hub.
system > workflowchannelnext
The page to direct users to immediately after creating a channel.
system > max_daily_registrations
Set the maximum number of new registrations allowed on any day.
Useful to prevent oversubscription after a bout of publicity
for the project.
system > tos_url
Set an alternative link for the ToS location.
system > block_public_search
Similar to block_public, except only blocks public access to
search features. Useful for sites that want to be public, but
keep getting hammered by search engines.
system > paranoia
As the pconfig, but on a site-wide basis. Can be overwritten
by member settings.
system > openssl_conf_file
Specify a file containing OpenSSL configuration. Read the code first.
If you can't read the code, don't play with it.
system > optimize_items
Runs optimise_table during some tasks to keep your database nice and
defragmented. This comes at a performance cost while the operations
are running, but also keeps things a bit faster while it's not.
There also exist CLI utilities for performing this operation, which you
may prefer, especially if you're a large site.
system > expire_limit
Don't expire any more than this number of posts per channel per
expiration run to keep from exhausting memory. Default 5000.
[b]system > dlogfile
Logfile to use for logging development errors. Exactly the same as
logger otherwise. This isn't magic, and requires your own logging
statements. Developer tool.
system > authlog
Logfile to use for logging auth errors. Used to plug in to server
side software such as fail2ban. Auth failures are still logged to
the main logs as well.
system > hide_in_statistics
Tell the red statistics servers to completely hide this hub in hub lists.
system > reserved_channels
Don't allow members to register channels with this comma separated
list of names (no spaces)
system > auto_follow
Make the first channel of an account auto-follow channels listed here - comma separated list of webbies (member@hub addresses).
system > admin_email
Specifies the administrator's email for this site. This is initially set during install.
system > cron_hour
Specify an hour in which to run cron_daily. By default with no config, this will run at midnight UTC.
system > minimum_feedcheck_minutes
The minimum interval between polling RSS feeds. If this is lower than the cron interval, feeds will be polled with each cronjob
system > blacklisted_sites
An array of specific hubs to block from this hub completely.
system > ignore_imagick
Ignore imagick and use GD, even if imagick is installed on the server. Prevents some issues with PNG files in older versions of imagick.
system > no_age_restriction
Do not restrict registration to people over the age of 13. This carries legal responsibilities in many countries to require that age be provided and to block all personal information from minors, so please check your local laws before changing.
system > override_poll_lockfile
Ignore the lock file in the poller process to allow more than one process to run at a time.
system > projecthome
Display the project page on your home page for logged out viewers.
system > sellpage
A URL shown in the public sites list to sell your hub - display service classes, etc.
randprofile > check
When requesting a random profile, check that it actually exists first
randprofile > retry
Number of times to retry getting a random profile
system > photo_cache_time
How long to cache photos, in seconds. Default is 86400 (1 day).
Longer time increases performance, but it also means it takes longer for changed permissions to apply.
system > poco_rating_enable
Distributed reputation reporting and data collection may be disabled. If your site does not participate in distributed reputation you will also not be able to make use of the data from your connections on other sites. By default and in the absence of any setting it is enabled. Individual members can opt out by restricting who can see their connections or by not providing any reputation information for their connections.
Return to the Main documentation page