Configuration reference

📒 Configuration reference

Tip

TL;DR All settings are system config keys, best kept in config/raw.config.php.

🔑 System config keys

Key	Type	Default	Details
allowed_raw_tokens	array of strings	[]	Enabling raw access
allowed_raw_token_wildcards	array of patterns	[]	Enabling raw access
raw_only_tokens	array of strings	[]	Raw-only mode
raw_only_token_wildcards	array of patterns	[]	Raw-only mode
raw_csp	array	[]	CSP configuration
raw_cache_public_max_age	int, seconds	300	Caching and HTTP behavior
raw_cache_public_stale_while_revalidate	int, seconds	30	Caching and HTTP behavior
raw_cache_public_stale_if_error	int, seconds	86400	Caching and HTTP behavior
raw_cache_private_no_store	bool	false	Caching and HTTP behavior
raw_sendfile_backend	off, apache, nginx	off	Webserver offload
raw_sendfile_allow_private	bool	false	Webserver offload
raw_sendfile_min_size_mb	int	0	Webserver offload
raw_sendfile_nginx_prefix	string	/_raw_sendfile	Webserver offload

🧷 App config

Key	Default	Details
csp_editor_group	admin	Content Security Policy

occ config:app:set files_sharing_raw csp_editor_group --value="<group>"

<group> is the id of the Nextcloud group whose members may edit per-share CSPs.

📄 A dedicated raw.config.php

Nextcloud loads every *.config.php in config/ and merges it with config.php. Keeping all raw settings in config/raw.config.php keeps them apart from the rest of the configuration.

<?php
$CONFIG = array (
  'allowed_raw_tokens' =>
  array (
    0 => 'html',
  ),
  'raw_cache_public_max_age' => 600,
  'raw_sendfile_backend' => 'apache',
);

Warning

Values in raw.config.php take precedence over config.php. When the file exists, edit raw settings there and do not rely on occ config:system:set for them.