Error de permisos en PrestaShop (DirectAdmin): Solución rápida

¿Qué significa el error de permisos de archivos en PrestaShop?

Cuando trabajas con PrestaShop en un servidor con panel DirectAdmin, es muy común encontrarte con errores relacionados con los permisos de archivos. Este error suele manifestarse de varias formas: no puedes subir imágenes, no se guardan los cambios en el catálogo, aparece un mensaje de "No se puede escribir en el archivo de configuración", o incluso la tienda se pone en blanco sin razón aparente.

El problema de fondo es que los archivos de tu tienda tienen asignados unos permisos (también llamados chmod) que no son los correctos. En el sistema operativo del servidor, cada archivo y carpeta tiene un conjunto de permisos que indican quién puede leer, escribir o ejecutar. Si esos permisos no coinciden con lo que PrestaShop necesita, la aplicación no puede funcionar correctamente.

A lo largo de esta guía te voy a explicar, paso a paso y sin tecnicismos innecesarios, cómo arreglar los permisos de archivos en PrestaShop usando DirectAdmin. No necesitas ser un experto, solo seguir las instrucciones con calma.

¿Por qué se producen los errores de permisos en PrestaShop?

Para entender cómo solucionarlo, primero hay que saber por qué ocurre. Estas son las causas más habituales:

Cambios en el servidor: Si tu proveedor de hosting actualiza PHP, cambia la configuración de Apache o modifica la política de seguridad, los permisos pueden quedar obsoletos.
Subida de archivos por FTP: Al subir archivos con un cliente FTP como FileZilla, a veces se asignan permisos incorrectos por defecto (por ejemplo, 644 en archivos cuando deberían ser 755).
Instalación de módulos o temas: Al instalar un módulo o plantilla de terceros, el proceso puede alterar permisos de carpetas críticas.
Restauración de copias de seguridad: Si restauras una copia de seguridad hecha en otro servidor, es muy probable que los permisos no coincidan con los del nuevo entorno.
Errores manuales: Algún usuario con acceso al panel pudo haber modificado los permisos sin querer.

Sea cual sea la causa, la solución pasa por restablecer los permisos correctos para cada tipo de archivo y carpeta.

Antes de empezar: ¿Qué permisos necesita PrestaShop?

PrestaShop, como la mayoría de aplicaciones PHP, necesita una estructura de permisos concreta. Te la resumo de forma sencilla:

Carpetas (directorios): Permiso 755. Esto significa que el propietario puede leer, escribir y ejecutar, y el resto del mundo solo puede leer y ejecutar.
Archivos: Permiso 644. El propietario puede leer y escribir, y el resto solo leer.

Sin embargo, hay algunas carpetas especiales que necesitan permisos más flexibles, generalmente 775 o incluso 777, para que PrestaShop pueda escribir en ellas. Las más importantes son:

/cache
/log
/img
/upload
/download
/themes
/override
/var/cache (en versiones modernas)
/var/logs (en versiones modernas)

[WARNING]
Asignar permisos 777 a todo el directorio de PrestaShop es un error grave de seguridad. Solo debes usar 777 en carpetas concretas y de forma temporal si es imprescindible. Después de solucionar el problema, vuelve a dejar los permisos en 755 o 775.

Cómo arreglar los permisos de archivos en PrestaShop desde DirectAdmin

DirectAdmin incluye un Administrador de Archivos integrado que te permite modificar los permisos sin necesidad de usar FTP. Es la forma más cómoda y segura. Vamos paso a paso.

Paso 1: Accede al Administrador de Archivos de DirectAdmin

Entra en tu panel de DirectAdmin. Normalmente es algo como https://tudominio.com:2222.
Introduce tu usuario y contraseña.
Busca la sección Administrador de Archivos (también puede aparecer como "File Manager").

[TIP]
Si no encuentras la opción, mira en la columna de la derecha dentro de tu cuenta de usuario. En algunos diseños de DirectAdmin está en "Herramientas" o "Avanzado".

Paso 2: Navega hasta la carpeta de PrestaShop

Una vez dentro del Administrador de Archivos, localiza la carpeta donde está instalada tu tienda. Normalmente es public_html, public_html/tienda o algo similar. Haz clic en el nombre para entrar.

Paso 3: Cambia los permisos de los archivos y carpetas

Ahora viene la parte importante. DirectAdmin te permite seleccionar múltiples archivos y carpetas para cambiar permisos en lote.

Opción A: Cambiar permisos de una carpeta completa

Marca la casilla de la carpeta raíz de tu PrestaShop (por ejemplo, public_html).
En la barra superior, haz clic en Cambiar permisos (o "Change Permissions").
Se abrirá una ventana con tres columnas: Usuario (Owner), Grupo (Group) y Público (Public).
Para carpetas, marca las casillas Lectura, Escritura y Ejecución para el Usuario; y Lectura y Ejecución para Grupo y Público. Esto equivale a 755.
Marca la opción "Aplicar a todos los archivos y subcarpetas" o similar. En DirectAdmin suele aparecer como "Aplicar recursivamente".
Pulsa Guardar.

Opción B: Cambiar permisos de archivos individuales

Si prefieres hacerlo de forma más controlada:

Haz clic derecho sobre un archivo o carpeta.
Selecciona Cambiar permisos.
Introduce el valor numérico directamente (por ejemplo, 644 para archivos, 755 para carpetas) o marca las casillas manualmente.
Guarda los cambios.

[INFO]
En DirectAdmin, también puedes escribir el valor numérico directamente en el campo "Permisos". Por ejemplo, escribir 755 y pulsar enter. Es más rápido que marcar casillas.

Paso 4: Restablece permisos específicos de las carpetas de PrestaShop

Después de aplicar los permisos generales, tienes que asegurarte de que las carpetas especiales tengan permisos de escritura. Te recomiendo hacer lo siguiente:

Ve a la carpeta /cache y cámbiala a 755 (o 775 si tu servidor usa grupo).
Haz lo mismo con /log, /img, /upload, /download, /themes, /override y /var.
En algunas versiones de PrestaShop, la carpeta /config también necesita permisos de escritura temporalmente.

[TIP]
Si después de esto sigues teniendo errores, prueba a poner las carpetas /cache y /log a 775 o incluso 777 temporalmente. Luego vuelve a bajarlas a 755.

Cómo arreglar los permisos usando comandos SSH (opcional)

Si tu plan de hosting te da acceso SSH, puedes hacerlo mucho más rápido con dos comandos. Pero solo si te sientes cómodo con la terminal.

find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;
find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;

Luego, para las carpetas especiales:

chmod -R 775 /ruta/a/tu/prestashop/cache
chmod -R 775 /ruta/a/tu/prestashop/log
chmod -R 775 /ruta/a/tu/prestashop/img

[WARNING]
Asegúrate de escribir bien la ruta. Un error aquí podría dejar tu tienda inaccesible. Si no estás seguro, usa el Administrador de Archivos de DirectAdmin.

Qué hacer si el error persiste después de cambiar los permisos

A veces, cambiar los permisos no es suficiente. Si el error de permisos en PrestaShop continúa, prueba estas soluciones adicionales:

1. Limpia la caché de PrestaShop

Ve a Parámetros avanzados > Rendimiento en tu panel de administración.
Pulsa el botón Vaciar caché.
Si no puedes acceder al panel, borra manualmente el contenido de /cache y /var/cache desde el Administrador de Archivos.

[INFO]
No borres la carpeta entera, solo su contenido. Así PrestaShop la regenerará automáticamente.

2. Comprueba el propietario de los archivos

En DirectAdmin, los archivos deben pertenecer a tu usuario. Si por algún motivo los archivos son propiedad de root o de otro usuario, el servidor no les dará permisos correctos.

En el Administrador de Archivos, mira la columna "Propietario".
Si no es tu usuario, contacta con tu proveedor de hosting para que lo cambien.

3. Desactiva temporalmente el modo de mantenimiento

A veces, el error de permisos impide que PrestaShop muestre la tienda correctamente. Activa el modo de mantenimiento desde el panel (o directamente editando el archivo /config/settings.inc.php), y luego vuelve a desactivarlo. Esto puede forzar la regeneración de archivos temporales.

4. Revisa el error 500 o pantalla blanca

Si ves un error 500, además de los permisos, puede haber un problema con el archivo .htaccess. Regenera el .htaccess desde Parámetros avanzados > Rendimiento o borrándolo y dejando que PrestaShop lo cree de nuevo.

Preguntas frecuentes sobre el error de permisos en PrestaShop

¿Por qué mi tienda muestra un error 500 después de cambiar permisos?

Lo más probable es que hayas cambiado los permisos de la carpeta /config o que hayas puesto permisos demasiado restrictivos en archivos críticos. Vuelve a poner los permisos estándar (644 archivos, 755 carpetas) y limpia la caché.

¿Es seguro usar 777 en PrestaShop?

No, no es seguro. Un permiso 777 permite que cualquier usuario del servidor pueda escribir en esos archivos, lo que es un riesgo de seguridad grave. Úsalo solo en carpetas específicas y de forma temporal.

¿Con qué frecuencia debo revisar los permisos de mi PrestaShop?

No hay una regla fija, pero es recomendable revisarlos después de instalar módulos, actualizar la tienda o restaurar copias de seguridad. También si notas comportamientos extraños.

¿Puedo usar FTP para cambiar permisos en DirectAdmin?

Sí, puedes usar FileZilla o cualquier cliente FTP. Simplemente haz clic derecho sobre el archivo o carpeta y selecciona "Permisos". El proceso es el mismo.

¿Qué pasa si no tengo acceso al Administrador de Archivos?

Si tu plan de hosting no incluye esta herramienta, contacta con tu proveedor. También puedes intentar acceder por FTP, que suele estar habilitado en todos los planes.

Consejos finales para evitar futuros errores de permisos

Haz copias de seguridad periódicas de tu tienda y base de datos.
Usa siempre el administrador de archivos de DirectAdmin en lugar de FTP para modificar archivos sensibles.
Actualiza PrestaShop y sus módulos regularmente. Las versiones nuevas suelen corregir problemas de permisos.
No instales módulos de fuentes desconocidas, ya que pueden alterar la estructura de permisos.
Si usas Syspanel (el panel alternativo basado en HestiaCP), recuerda que el acceso se realiza por el puerto 2106 y que los pasos para cambiar permisos son muy similares, aunque la interfaz cambia ligeramente.

[TIP]
Anota en un papel los permisos correctos (644 archivos, 755 carpetas) y pégalo cerca de tu escritorio. Te ahorrará muchos dolores de cabeza.

Resumen rápido

Arreglar el error de permisos de archivos en PrestaShop con DirectAdmin es un proceso sencillo si sabes dónde mirar:

Accede al Administrador de Archivos de DirectAdmin.
Selecciona la carpeta raíz de tu tienda.
Aplica 755 a todas las carpetas y 644 a todos los archivos.
Da permisos especiales (775 o 777 temporal) a las carpetas /cache, /log, /img, /upload, /download, /themes y /override.
Limpia la caché de PrestaShop.
Si el error persiste, revisa el propietario de los archivos y contacta con tu hosting si es necesario.

Con estos pasos, tu tienda debería volver a funcionar con normalidad. Y recuerda: los permisos de archivos son la base de cualquier aplicación PHP. Mantenerlos en orden es una de las mejores prácticas para que tu PrestaShop sea rápido, seguro y estable.

Si sigues teniendo problemas después de probar todo esto, no dudes en escribir a tu proveedor de hosting. Ellos podrán revisar los registros del servidor y ver si hay algo más profundo que esté causando el conflicto.