Nextcloud config.php: toda la in­fo­r­ma­ción clave sobre el archivo de co­n­fi­gu­ra­ción

El archivo config.php de Nextcloud es el principal archivo de co­n­fi­gu­ra­ción de este popular software en la nube y se encarga de gestionar varios de los aspectos fu­n­da­me­n­ta­les del fu­n­cio­na­mie­n­to del servidor. Se puede modificar fá­ci­l­me­n­te con un editor de texto, pero cualquier cambio debe hacerse con pre­cau­ción, ya que una co­n­fi­gu­ra­ción in­co­rre­c­ta puede provocar ine­s­ta­bi­li­dad o errores.

De­fi­ni­ción: ¿qué es el archivo config.php de Nextcloud?

En Nextcloud, el archivo config.php actúa como archivo central de co­n­fi­gu­ra­ción para muchos de los ajustes fu­n­da­me­n­ta­les del fu­n­cio­na­mie­n­to del servidor. Entre ellos se incluyen pa­rá­me­tros básicos del servidor, co­ne­xio­nes con bases de datos, así como variables re­la­cio­na­das con la seguridad y el re­n­di­mie­n­to. También es posible definir en este archivo opciones de registro de Nextcloud, como el nivel de registro (log level) o el método de registro utilizado.

Sin embargo, hay muchas co­n­fi­gu­ra­cio­nes de Nextcloud que no están incluidas en el archivo config.php. Por ejemplo, la co­n­fi­gu­ra­ción de las apli­ca­cio­nes de Nextcloud suele ge­s­tio­nar­se di­re­c­ta­me­n­te desde cada apli­ca­ción.

El archivo de co­n­fi­gu­ra­ción es una he­rra­mie­n­ta im­pre­s­ci­n­di­ble para pe­r­so­na­li­zar y gestionar Nextcloud de forma in­di­vi­dual. Se suele modificar tanto durante la in­s­ta­la­ción del software como cuando se realizan cambios en la in­frae­s­tru­c­tu­ra de la nube o durante tareas de ma­n­te­ni­mie­n­to y re­so­lu­ción de errores. Por eso es im­po­r­ta­n­te que quienes ad­mi­ni­s­tran Nextcloud sepan cómo trabajar con el archivo config.php.

El formato del archivo config.php

En general, el archivo config.php de Nextcloud es un archivo de texto plano con ciertos re­qui­si­tos de formato para los distintos pa­rá­me­tros y valores. Esto permite que el archivo sea fá­ci­l­me­n­te ampliable y que la in­ter­ac­ción con el software de Nextcloud sea más sencilla. Además, puede vi­sua­li­zar­se con cualquier editor de texto o desde la línea de comandos.

Desde el punto de vista técnico, se trata de un archivo PHP que contiene un array especial llamado $CONFIG. Este mapa ordenado asocia claves con valores. Los distintos pa­rá­me­tros pueden ser de varios tipos de datos:

• Integer: números enteros como “0”, “1”, “2” o “3”
• Float: números decimales como “1,234” o “77,55”
• String: cadenas de texto de hasta cuatro kilobytes, como “abcdefg”
• Boolean: valores booleanos, que pueden ser true (verdadero) o false (falso)

Cargar el archivo config.php de Nextcloud

El archivo config.php se encuentra en el di­re­c­to­rio config/ dentro de la in­s­ta­la­ción de Nextcloud y puede ampliarse con otros archivos ubicados en esa misma carpeta. Para ello, deben seguir el formato *.config.php y estar co­rre­c­ta­me­n­te es­tru­c­tu­ra­dos.

Cada vez que Nextcloud se inicia, analiza au­to­má­ti­ca­me­n­te si hay cambios en el archivo config.php, y durante la ejecución también se realizan co­m­pro­ba­cio­nes pe­rió­di­cas. Con la co­n­fi­gu­ra­ción pre­de­te­r­mi­na­da de OPcache, Nextcloud revisa el di­re­c­to­rio cada dos segundos en busca de ac­tua­li­za­cio­nes; sin embargo, en la mayoría de las versiones pre­co­n­fi­gu­ra­das, este intervalo suele ser de unos 60 segundos.

¿Cómo editar el archivo config.php de Nextcloud?

Si quieres editar el archivo config.php de Nextcloud, sigue estos pasos:

1. Antes de modificar el archivo de co­n­fi­gu­ra­ción, haz siempre una copia de seguridad. El comando adecuado sería: sudo cp /var/snap/nextcloud/current/nextcloud/config/config.php config.php.bak.
2. A co­n­ti­nua­ción, abre el archivo en tu editor de texto local con el siguiente comando: sudo nano /var/snap/nextcloud/current/nextcloud/config/config.php.
3. Añade los pa­rá­me­tros que necesites o modifica las entradas exi­s­te­n­tes.
4. Guarda los cambios y comprueba después si el servidor de Nextcloud funciona co­rre­c­ta­me­n­te.

Es muy im­po­r­ta­n­te prestar atención a la sintaxis correcta, ya que incluso una coma olvidada o una comilla mal colocada puede afectar gra­ve­me­n­te al sistema. Una sintaxis in­co­rre­c­ta no solo puede provocar fallos de fu­n­cio­na­mie­n­to, sino también problemas de seguridad y una pérdida del re­n­di­mie­n­to. Para detectar y so­lu­cio­nar posibles errores de forma más sencilla, se re­co­mie­n­da aplicar los cambios de manera gradual.

Pri­n­ci­pa­les pa­rá­me­tros de co­n­fi­gu­ra­ción

El archivo config.php de Nextcloud permite ajustar de forma flexible una gran variedad de pa­rá­me­tros. Puedes encontrar una lista completa de todos los pa­rá­me­tros di­s­po­ni­bles, junto con co­me­n­ta­rios útiles, en el archivo config.sample.php, que se instala au­to­má­ti­ca­me­n­te junto con Nextcloud. Para una de­s­cri­p­ción detallada de cada variable, consulta la do­cu­me­n­ta­ción oficial de Nextcloud. A co­n­ti­nua­ción, te ofrecemos un resumen con los pa­rá­me­tros más im­po­r­ta­n­tes que todo ad­mi­ni­s­tra­dor debería conocer y modificar si es necesario:

Co­n­fi­gu­ra­ción básica

• dbtype: tipo de base de datos
• dbname: nombre de la base de datos utilizada
• dbhost: nombre del host o dirección IP del servidor de base de datos
• trusted_domains: define desde qué dominios o IP se permite el acceso

Ex­pe­rie­n­cia de usuario

• default.language: establece el idioma por defecto
• default.phone.region: define la región pre­de­te­r­mi­na­da para números de teléfono

Sesiones de usuario

• remember_login_cookie_lifetime: define la duración de la cookie de inicio de sesión
• session_lifetime: determina cuándo expira una sesión inactiva

Correo

• mail_domain: define la dirección del remitente para los correos salientes