Permisos incorrectos en PrestaShop DirectAdmin: Cómo arreglarlos

Los errores de permisos de archivos son una de las causas más frecuentes de problemas en tiendas PrestaShop, especialmente cuando se gestiona el hosting a través de un panel como DirectAdmin. Si tu tienda de repente muestra una pantalla en blanco, no puedes subir imágenes, o ves mensajes de error al intentar acceder al back office, es muy probable que los permisos de tus archivos o carpetas estén mal configurados.

En esta guía extensa, te explicaré de forma clara y paso a paso qué son los permisos de archivos, por qué son importantes en PrestaShop, cuáles son los errores más comunes que puedes encontrar en DirectAdmin y cómo solucionarlos de manera segura. No necesitas ser un experto técnico; solo sigue las instrucciones y tu tienda volverá a funcionar correctamente.

¿Qué son los permisos de archivos y por qué son críticos en PrestaShop?

Los permisos de archivos son un sistema de seguridad que define quién puede leer, escribir o ejecutar un archivo o carpeta en tu servidor. En un entorno Linux (el más común en hosting compartido), cada archivo y directorio tiene tres niveles de permisos:

Propietario (Owner): El usuario que creó el archivo (normalmente tu cuenta de hosting).
Grupo (Group): Un conjunto de usuarios que pueden tener acceso.
Público (Others): Cualquier otro usuario que acceda al servidor (incluyendo visitantes de tu web).

Cada nivel puede tener tres tipos de permisos: lectura (r), escritura (w) y ejecución (x). En PrestaShop, la configuración incorrecta de estos permisos puede provocar:

Que no se puedan guardar cambios en el back office.
Que las imágenes no se suban o no se muestren.
Que los módulos no se instalen o actualicen.
Que aparezcan errores 500 o pantallas en blanco.
Que el sistema de archivos deje de funcionar parcial o totalmente.

PrestaShop necesita ciertos permisos específicos para funcionar correctamente, especialmente para carpetas como cache, img, modules y config. Un error muy común es dejar permisos demasiado restrictivos o, por el contrario, demasiado permisivos (como 777), lo que supone un riesgo de seguridad.

Errores comunes de permisos archivos PrestaShop en DirectAdmin

Cuando gestionas tu hosting con DirectAdmin, puedes encontrarte con varios escenarios típicos que indican un problema de permisos. Aquí te detallo los más frecuentes y cómo identificarlos.

1. Error al subir imágenes o productos

Si al intentar añadir una imagen a un producto ves un mensaje como "Error al subir la imagen" o la imagen no se guarda, el problema suele estar en los permisos de la carpeta img. PrestaShop necesita poder escribir en img/p y sus subcarpetas para almacenar las imágenes redimensionadas.

Síntoma típico: Las imágenes se ven rotas o no aparecen en la tienda, aunque el producto se guarde.

2. Pantalla en blanco al acceder al back office o front office

Una pantalla completamente blanca (error 500) puede deberse a que PrestaShop no puede escribir en la carpeta cache. Sin permisos de escritura, el sistema no puede generar archivos temporales ni actualizar la configuración.

Síntoma típico: La web carga pero se queda en blanco, o al intentar acceder al panel de administración ves una página vacía.

3. Error al instalar o actualizar módulos

Cuando intentas instalar un módulo desde el back office y recibes un error de "No se puede escribir en el directorio" o "El módulo no se ha podido descargar", es probable que la carpeta modules o config tenga permisos incorrectos.

Síntoma típico: El módulo se descarga pero no se instala, o aparece un mensaje de error directo.

4. Error al editar archivos desde el back office (traducciones, temas)

Si modificas traducciones o personalizas un tema y los cambios no se guardan, el problema está en los permisos de las carpetas translations o themes. PrestaShop necesita escribir en estas carpetas para almacenar tus modificaciones.

Síntoma típico: Realizas cambios, los guardas, pero al recargar la página todo vuelve a estar como antes.

5. Error "No se puede escribir en la carpeta de configuración"

Este error aparece directamente en el back office o en un mensaje de alerta. Indica que la carpeta config no tiene permisos de escritura, lo que impide que PrestaShop guarde ajustes básicos como la URL de la tienda o la configuración de la base de datos.

Síntoma típico: Mensaje de error rojo en la parte superior del back office.

Cómo verificar y corregir permisos archivos PrestaShop en DirectAdmin

Para solucionar estos errores, necesitas acceder al panel de control de DirectAdmin y utilizar el Administrador de Archivos. Sigue estos pasos con cuidado.

Paso 1: Accede al Administrador de Archivos de DirectAdmin

Inicia sesión en tu panel de DirectAdmin (normalmente en tudominio.com:2222).
Busca y haz clic en Administrador de Archivos (File Manager).
Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o una subcarpeta como tienda).

Paso 2: Identifica los permisos actuales

En el Administrador de Archivos, cada archivo y carpeta muestra una columna de "Permisos" con valores como 755, 644 o 777. Los números representan los permisos en formato octal:

755 (rwxr-xr-x): El propietario puede leer, escribir y ejecutar; el grupo y otros solo pueden leer y ejecutar. Es el permiso estándar para carpetas.
644 (rw-r--r--): El propietario puede leer y escribir; el grupo y otros solo pueden leer. Es el permiso estándar para archivos.
777 (rwxrwxrwx): Todos pueden leer, escribir y ejecutar. Es inseguro y no recomendado.

Paso 3: Establece los permisos correctos para PrestaShop

PrestaShop recomienda los siguientes permisos para un funcionamiento óptimo y seguro:

Carpetas (directorios): 755 (o 750 si tu hosting lo permite, pero 755 es más universal).
Archivos: 644 (o 640 para mayor seguridad).
Archivos de configuración sensibles: settings.inc.php y parameters.php deben tener permisos 644 o incluso 444 (solo lectura) después de la instalación.
Carpetas especiales que necesitan escritura: cache, config, img, log, modules, themes, translations, upload, download, sitemap. Estas deben tener permisos 755 y pertenecer al usuario correcto.

Para cambiar permisos en DirectAdmin:

Selecciona la carpeta o archivo haciendo clic en la casilla.
Haz clic en el botón Cambiar permisos (a veces aparece como un icono de candado).
Introduce el valor numérico (por ejemplo, 755 para carpetas) y haz clic en Aceptar.

[TIP] Si tienes muchas carpetas, usa la opción "Cambiar permisos recursivamente" para aplicar los cambios a todas las subcarpetas y archivos. Pero cuidado: no apliques 755 a archivos individuales, solo a carpetas.

Paso 4: Verifica el propietario de los archivos

A veces los permisos están bien pero el propietario es incorrecto. En DirectAdmin, los archivos deben pertenecer al usuario de tu cuenta de hosting (normalmente el mismo nombre que tu usuario de DirectAdmin). Si ves que el propietario es nobody o apache, puede causar problemas.

Para cambiarlo:

Selecciona la carpeta raíz de PrestaShop.
Haz clic en Cambiar propietario (o "Change Owner").
Selecciona tu usuario de DirectAdmin de la lista.
Marca la opción "Recursivo" para aplicar a todo el contenido.

[WARNING] No cambies el propietario a nobody o www-data a menos que sepas exactamente lo que haces. Esto puede romper la seguridad de tu hosting.

Cómo solucionar errores específicos con chmod PrestaShop

Si prefieres usar comandos SSH (si tu hosting lo permite), puedes usar chmod para cambiar permisos de forma masiva. Pero si no tienes acceso SSH, el Administrador de Archivos de DirectAdmin es suficiente. Aquí te explico cómo resolver los errores más comunes.

Error de imágenes: soluciona la carpeta img

Ve al Administrador de Archivos.
Localiza la carpeta img dentro de tu instalación de PrestaShop.
Cambia sus permisos a 755 (recursivamente, pero solo para carpetas).
Dentro de img, busca la carpeta p (productos) y también cambia sus permisos a 755.
Asegúrate de que los archivos dentro de img/p tengan permisos 644.

[INFO] Si después de esto sigues teniendo problemas, puede que el problema sea de espacio en disco o de cuota de archivos. Verifica en DirectAdmin si tu plan tiene suficiente espacio.

Error de pantalla en blanco: limpia la caché y corrige permisos

Cambia los permisos de la carpeta cache a 755 recursivamente.
Dentro de cache, busca la carpeta smarty y cambia sus permisos a 755.
Elimina el contenido de cache/smarty/cache y cache/smarty/compile (no borres las carpetas, solo los archivos internos).
Vuelve a intentar acceder a tu tienda. Si sigue en blanco, revisa también la carpeta config.

Error de módulos: corrige modules y config

Cambia los permisos de la carpeta modules a 755 recursivamente.
Dentro de modules, cada módulo debe tener su carpeta con permisos 755 y archivos 644.
La carpeta config debe tener permisos 755. El archivo settings.inc.php debe tener 644 o 444.
Si instalaste un módulo manualmente por FTP, asegúrate de que los archivos subidos tengan los permisos correctos.

[TIP] Después de instalar un módulo, es buena práctica volver a poner los permisos de config/settings.inc.php a 444 para mayor seguridad.

Preguntas frecuentes (FAQ) sobre permisos archivos PrestaShop

¿Qué permisos debe tener la carpeta cache en PrestaShop?

La carpeta cache y todas sus subcarpetas (como smarty) deben tener permisos 755. Los archivos dentro de cache deben tener 644. Esto permite que PrestaShop escriba archivos temporales y los borre cuando sea necesario.

¿Es seguro usar permisos 777 en PrestaShop?

No, absolutamente no. El permiso 777 permite que cualquier usuario en el servidor (incluyendo posibles atacantes) pueda leer, escribir y ejecutar archivos. Solo deberías usarlo temporalmente para solucionar un error y luego volver a 755 o 644. Nunca dejes 777 de forma permanente.

¿Por qué DirectAdmin muestra permisos diferentes a los que configuré?

Esto puede pasar si tu hosting tiene un "umask" especial o si el servidor está configurado con PHP como módulo de Apache (mod_php) en lugar de PHP-FPM. En ese caso, los archivos creados por PHP pueden tener propietario nobody. Si ves esto, contacta con tu proveedor de hosting para que ajuste la configuración.

¿Cómo puedo saber si el problema es de permisos o de otra cosa?

Prueba a crear un archivo de prueba desde el Administrador de Archivos. Si puedes crear y editar archivos sin problemas, el problema es específico de PrestaShop. Si no puedes, el problema es de permisos generales de tu cuenta.

¿Afecta el uso de Syspanel (HestiaCP) en los permisos?

Si tu hosting usa Syspanel (HestiaCP, puerto 2106), el proceso es similar, pero la interfaz es diferente. En Syspanel, el Administrador de Archivos suele tener opciones para cambiar permisos de forma visual. Los principios son los mismos: carpetas 755, archivos 644. La principal diferencia es que en Syspanel el propietario suele ser admin o el nombre de tu cuenta, y debes asegurarte de que los archivos no pertenezcan a root.

[WARNING] Si estás en un hosting con Syspanel, evita usar comandos SSH para cambiar propietarios a menos que sepas exactamente lo que haces. Usa siempre el panel web.

Consejos finales para mantener los permisos correctos

Haz copias de seguridad periódicas: Antes de hacer cambios masivos de permisos, asegúrate de tener un backup reciente de tu tienda y base de datos.
Actualiza PrestaShop regularmente: Las versiones antiguas pueden tener vulnerabilidades que se agravan con permisos incorrectos.
Usa un módulo de seguridad: Algunos módulos de PrestaShop pueden ayudarte a verificar y corregir permisos automáticamente desde el back office.
Revisa los logs del servidor: En DirectAdmin, puedes acceder a "Registros de errores" (Error Logs) para ver exactamente qué archivo está causando el problema. Busca mensajes como "Permission denied" o "failed to open stream".

Los errores de permisos archivos PrestaShop en DirectAdmin pueden ser frustrantes, pero con esta guía paso a paso podrás resolverlos tú mismo sin necesidad de llamar al soporte técnico. Recuerda siempre mantener un equilibrio entre seguridad y funcionalidad: permisos demasiado restrictivos rompen la tienda, y permisos demasiado abiertos la ponen en riesgo. Con 755 para carpetas y 644 para archivos, estarás en el punto justo.

Si después de seguir todos estos pasos el problema persiste, puede que el error no sea de permisos sino de configuración de PHP, memoria insuficiente o problemas con la base de datos. En ese caso, no dudes en contactar con tu proveedor de hosting, indicándoles que ya has verificado los permisos según las recomendaciones de PrestaShop.