Permisos de archivos en DirectAdmin para PrestaShop | Tutorial

¿Por qué son importantes los permisos de archivos en PrestaShop?

Cuando trabajas con PrestaShop, una de las tareas de mantenimiento más comunes (y a veces frustrantes) es lidiar con los permisos de archivos y carpetas. Si alguna vez has visto un error como "No se puede escribir en el archivo de configuración" o has intentado subir un módulo y no se instala, el problema casi siempre está en los permisos.

Los permisos determinan quién puede leer, escribir o ejecutar un archivo o directorio en tu servidor. En un entorno de hosting compartido o VPS con DirectAdmin, estos permisos son esenciales para que tu tienda funcione correctamente y, al mismo tiempo, esté segura.

Piensa en los permisos como las cerraduras de una puerta: si le das demasiado acceso a todo el mundo, cualquiera podría entrar y modificar tu tienda. Si le das muy poco, ni siquiera tú podrás actualizar tu catálogo de productos.

En este artículo, te explicaré de forma sencilla y paso a paso cómo cambiar los permisos de archivos en DirectAdmin para PrestaShop. No necesitas ser un experto en programación, solo seguir estas instrucciones al pie de la letra.

Entendiendo los permisos: el sistema CHMOD

Antes de entrar en materia, es fundamental que entiendas qué es el famoso chmod. Este comando, que proviene de "change mode" (cambiar modo), es el que usamos para modificar los permisos de un archivo o carpeta en sistemas Linux, que es el sistema operativo que usa la mayoría de los servidores de hosting.

Cada archivo o carpeta tiene tres tipos de permisos:

Lectura (r): Permite ver el contenido del archivo o listar los archivos de una carpeta.
Escritura (w): Permite modificar el contenido del archivo o crear/eliminar archivos dentro de una carpeta.
Ejecución (x): Permite ejecutar el archivo (si es un script) o acceder a la carpeta.

Estos permisos se asignan a tres grupos de usuarios:

Propietario (u): Normalmente eres tú, el dueño de la cuenta de hosting.
Grupo (g): Un grupo de usuarios del servidor que comparten permisos.
Público (o): Todos los demás usuarios del servidor.

Cuando ves un número como 755 o 644, es la representación numérica de estos permisos. Cada permiso tiene un valor:

Lectura = 4
Escritura = 2
Ejecución = 1

Se suman los valores para cada grupo. Por ejemplo, 755 significa:

Propietario: 7 (4+2+1) = lectura, escritura y ejecución.
Grupo: 5 (4+1) = lectura y ejecución.
Público: 5 (4+1) = lectura y ejecución.

Permisos recomendados para PrestaShop

PrestaShop, como la mayoría de los CMS, tiene unas recomendaciones específicas para los permisos. No es algo aleatorio, sino que sigue una lógica de seguridad.

Permisos para archivos

Archivos de configuración (como config/settings.inc.php): Lo ideal es 444 (solo lectura para todos) o 644 (lectura y escritura solo para el propietario). Esto evita que alguien externo los modifique.
Archivos de código fuente (.php, .js, .css): Generalmente 644. El propietario puede leer y escribir, el resto solo leer.
Archivos de caché (en var/cache o cache/): Pueden necesitar 666 o 664 para que PrestaShop pueda escribir en ellos temporalmente.

Permisos para carpetas

Carpetas de código (como classes/, controllers/, src/): 755. El propietario tiene todos los permisos, el resto solo lectura y ejecución.
Carpetas de archivos subidos (como img/, download/, var/, themes/): 755 o 775. En algunos casos, si tienes problemas para subir imágenes o módulos, necesitarás 777 temporalmente.

[WARNING] Nunca dejes tus carpetas en 777 de forma permanente. Es un riesgo de seguridad grave, ya que cualquier usuario del servidor podría escribir en ellas. Úsalo solo como solución temporal y vuelve a 755 o 775 cuando termines.

Cómo cambiar permisos en DirectAdmin: el método gráfico

DirectAdmin es un panel de control muy intuitivo, así que cambiar los permisos es bastante sencillo. Vamos a hacerlo paso a paso.

Paso 1: Accede al Administrador de Archivos

Primero, inicia sesión en tu panel de DirectAdmin. La URL suele ser algo como https://tu-dominio.com:2222, pero puede variar según tu proveedor de hosting.

Una vez dentro, busca la sección "Administrador de Archivos" (File Manager). Normalmente está en la parte principal del panel o dentro de la sección "Administración de archivos".

Paso 2: Navega hasta tu instalación de PrestaShop

En el Administrador de Archivos, verás una estructura de carpetas. Deberías encontrar una carpeta llamada domains, dentro de ella tu-dominio.com, y luego public_html (o htdocs). Ahí es donde está instalado PrestaShop.

Haz clic en public_html para entrar.

Paso 3: Selecciona los archivos o carpetas

Ahora viene la parte importante. Puedes cambiar los permisos de un archivo individual, de una carpeta completa o de varios archivos a la vez.

Para un archivo o carpeta: Haz clic derecho sobre él y selecciona la opción "Cambiar permisos" o "Permissions". También puedes marcar la casilla junto al archivo o carpeta y buscar el botón de permisos en la barra superior.
Para múltiples archivos: Marca las casillas de todos los que quieras modificar y luego haz clic en el botón de permisos.

Paso 4: Asigna los valores

Se abrirá una ventana emergente donde podrás ver tres columnas: Usuario (propietario), Grupo y Público. En cada columna verás casillas para Lectura, Escritura y Ejecución.

Puedes marcar las casillas manualmente o, si prefieres, en la parte inferior de la ventana hay un campo donde puedes escribir directamente el valor numérico (como 755).

Aquí te dejo una guía rápida:

Para carpetas, marca: Propietario (Lectura, Escritura, Ejecución), Grupo (Lectura, Ejecución), Público (Lectura, Ejecución). Esto es 755.
Para archivos de código, marca: Propietario (Lectura, Escritura), Grupo (Lectura), Público (Lectura). Esto es 644.

Paso 5: Aplica los cambios

Una vez que hayas seleccionado los permisos, haz clic en "Cambiar" o "Guardar". El sistema aplicará los cambios al instante.

Cambiar permisos usando el comando CHMOD desde la terminal

Si te sientes más cómodo con la línea de comandos o necesitas cambiar permisos de forma masiva, puedes usar el acceso SSH que suele estar disponible en DirectAdmin.

Paso 1: Activa el acceso SSH

En DirectAdmin, ve a la sección "Acceso SSH" o "SSH Keys". Si tu proveedor lo permite, podrás generar una clave o usar una contraseña para conectarte.

[INFO] Si no tienes acceso SSH, no te preocupes. El método gráfico del Administrador de Archivos es suficiente para el 99% de los casos. Solo necesitas SSH para tareas muy avanzadas o automatización.

Paso 2: Conéctate a tu servidor

Usa un programa como PuTTY (en Windows) o la terminal (en Mac/Linux) para conectarte:

ssh usuario@tu-dominio.com -p 2222

Paso 3: Navega a tu carpeta de PrestaShop

Una vez conectado, escribe:

cd domains/tu-dominio.com/public_html

Paso 4: Cambia los permisos con el comando chmod

Ahora puedes usar el comando chmod de varias formas:

Cambiar permisos de un archivo:

chmod 644 config/settings.inc.php

Cambiar permisos de una carpeta:

chmod 755 img/

Cambiar permisos de forma recursiva (para una carpeta y todo su contenido):

chmod -R 755 themes/

[WARNING] Ten mucho cuidado con el comando -R (recursivo). Si lo usas en una carpeta equivocada, cambiarás los permisos de miles de archivos y podrías romper tu tienda. Úsalo solo cuando estés seguro de lo que haces.

Solución de problemas comunes con permisos en PrestaShop

Ahora que ya sabes cómo cambiar los permisos, vamos a ver los problemas más habituales y cómo solucionarlos.

Error: "No se puede escribir en el archivo de configuración"

Este error suele aparecer al instalar un módulo o al intentar guardar los ajustes. La solución es dar permisos de escritura temporal a la carpeta config/ y al archivo settings.inc.php.

Cambia los permisos de config/ a 755 y settings.inc.php a 644.
Realiza la operación que te daba error.
Vuelve a poner config/ a 755 y settings.inc.php a 444 por seguridad.

Error: "No se pueden subir imágenes"

Si no puedes subir imágenes de productos, el problema suele estar en las carpetas img/ y download/.

Cambia los permisos de img/ a 755 o 775.
Si sigue fallando, prueba con 777 temporalmente.
Después de subir las imágenes, vuelve a 755.

Error: "No se puede instalar el módulo"

PrestaShop necesita escribir en varias carpetas al instalar un módulo. Las más comunes son modules/, var/ y themes/.

Cambia los permisos de modules/ a 755.
Cambia los permisos de var/cache/ a 755.
Intenta instalar el módulo de nuevo.
Restaura los permisos a 755 para las carpetas y 644 para los archivos.

La regla de oro: menos es más

Siempre que termines de hacer cambios, vuelve a los permisos más restrictivos posibles. Un buen hábito es:

Carpetas: 755
Archivos: 644
Archivos de configuración: 444 o 644

Esto mantiene tu tienda segura y funcionando correctamente.

[TIP] Haz una copia de seguridad de tu base de datos y archivos antes de hacer cambios masivos de permisos. Si algo sale mal, podrás restaurar todo sin perder información.

Preguntas frecuentes sobre permisos en DirectAdmin y PrestaShop

¿Qué pasa si pongo todos los permisos en 777?

Tu tienda funcionará, pero será extremadamente vulnerable. Cualquier persona con acceso al servidor podría modificar tus archivos, inyectar código malicioso o robar información de tus clientes. Es como dejar la puerta de tu casa abierta de par en par.

¿Por qué no puedo cambiar los permisos desde el Administrador de Archivos?

A veces, el Administrador de Archivos no muestra la opción de permisos si el archivo o carpeta pertenece a otro usuario del servidor. En ese caso, contacta con tu proveedor de hosting para que te ayude.

¿Los permisos afectan al rendimiento de mi tienda?

No directamente. Los permisos no influyen en la velocidad de carga, pero sí en la seguridad y en la capacidad de PrestaShop para funcionar correctamente.

¿Cada cuánto debo revisar los permisos?

No hay una regla fija. Lo recomendable es revisarlos después de cada actualización de PrestaShop, de instalar o desinstalar módulos, o si notas comportamientos extraños en tu tienda.

¿Qué diferencia hay entre DirectAdmin y Syspanel?

DirectAdmin y Syspanel (anteriormente HestiaCP) son paneles de control de hosting diferentes. Syspanel se accede a través del puerto 2106, mientras que DirectAdmin suele usar el puerto 2222. Los pasos para cambiar permisos son similares en ambos, pero la interfaz varía.

Conclusión: dominar los permisos es clave para tu PrestaShop

Cambiar los permisos de archivos en DirectAdmin para PrestaShop no es una tarea complicada, pero requiere atención y cuidado. Con esta guía, ya tienes el conocimiento necesario para:

Entender qué son los permisos y cómo funcionan.
Aplicar los valores correctos (755 para carpetas, 644 para archivos).
Solucionar problemas comunes de escritura y subida de archivos.
Mantener tu tienda segura evitando permisos demasiado abiertos.

Recuerda siempre la regla de oro: usa los permisos más restrictivos posibles y solo aumenta temporalmente cuando sea necesario. Si sigues estos consejos, tu PrestaShop funcionará sin problemas y estará protegida contra accesos no deseados.

¿Tienes alguna duda más? Déjala en los comentarios y estaré encantado de ayudarte. ¡Buena suerte con tu tienda online!