Problemas de permisos en PrestaShop con DirectAdmin: solución

¿Tu tienda PrestaShop se ha vuelto loca? ¿Ves errores extraños como "no se puede escribir el archivo", "permiso denegado" o directamente la página en blanco? No te preocupes, es uno de los problemas más comunes al gestionar un hosting con DirectAdmin. En esta guía te voy a explicar paso a paso cómo solucionar problemas de permisos en PrestaShop con DirectAdmin, desde entender qué son hasta cambiarlos de forma segura.

Vamos a ello. Te prometo que es más fácil de lo que parece.

¿Qué son los permisos de archivos y por qué son importantes en PrestaShop?

Imagina que tu servidor es un edificio con muchas puertas. Cada archivo y carpeta de tu PrestaShop tiene una cerradura con tres tipos de llaves: una para el dueño (tú), otra para el grupo (otros usuarios del servidor) y otra para el resto del mundo (los visitantes). Los permisos determinan quién puede leer, escribir o ejecutar cada archivo.

En PrestaShop, los permisos incorrectos son la causa número 1 de errores como:

No poder subir imágenes o módulos.
Que la tienda se ponga en blanco (pantalla blanca de la muerte).
Errores al instalar o actualizar temas.
Problemas con el carrito de compras o el panel de administración.

Por eso, saber cambiar permisos archivos PrestaShop es una habilidad básica que todo dueño de tienda debe dominar.

El error típico: "permiso denegado" al instalar un módulo o tema

Cuando intentas subir un módulo o tema desde el panel de administración de PrestaShop y ves un mensaje como "No se puede escribir en el directorio" o "Error de permisos", es señal de que los archivos no tienen los permisos correctos. Lo mismo ocurre si al acceder a tu tienda ves un error 500 o una página en blanco.

Este error permisos PrestaShop suele aparecer después de:

Migrar tu tienda a un nuevo hosting.
Restaurar una copia de seguridad.
Actualizar PrestaShop a una versión más reciente.
Cambiar la configuración del servidor (por ejemplo, al pasar de PHP 7.4 a 8.0).

Requisitos previos antes de tocar permisos

Antes de lanzarte a cambiar permisos como un loco, ten en cuenta estas reglas de oro:

[WARNING] No modifiques permisos sin hacer una copia de seguridad completa de tu tienda (archivos y base de datos). Un error puede dejar tu tienda inaccesible.

[INFO] Los permisos correctos para PrestaShop son:

Archivos: 644 (dueño puede leer/escribir, grupo y otros solo leer).
Carpetas: 755 (dueño puede leer/escribir/ejecutar, grupo y otros solo leer/ejecutar).
Archivos de configuración (como settings.inc.php): 444 o 440 después de la instalación.

Además, necesitas acceso a DirectAdmin (tu panel de hosting) y saber tu usuario y contraseña. Si usas Syspanel (antes HestiaCP), el puerto de acceso es el 2106.

Paso a paso: cómo cambiar permisos en DirectAdmin

Voy a explicarte dos métodos: desde el administrador de archivos de DirectAdmin (el más fácil para principiantes) y desde la línea de comandos (si te sientes más avanzado).

Método 1: Usando el Administrador de Archivos de DirectAdmin

Este método es visual y no requiere conocimientos técnicos.

Accede a DirectAdmin: Abre tu navegador y escribe tudominio.com:2222 (o la IP que te haya dado tu proveedor). Inicia sesión con tus credenciales.
Ve al Administrador de Archivos: En el panel principal, busca el icono "Administrador de Archivos" (File Manager). Haz clic.
Localiza tu carpeta de PrestaShop: Normalmente está en public_html o domains/tudominio.com/public_html. Si tienes varios dominios, asegúrate de elegir el correcto.
Selecciona todos los archivos y carpetas: En la parte superior, marca la casilla "Seleccionar todo" o haz clic en la primera carpeta, presiona Ctrl+A (Cmd+A en Mac) y luego mantén presionada la tecla Ctrl mientras haces clic en los archivos que quieras modificar.
Cambia los permisos: En la barra de herramientas superior, busca el botón "Permisos" (a veces tiene un icono de candado). Se abrirá una ventana.
Configura los permisos correctos:
- Para archivos: Marca las casillas de "Lectura" y "Escritura" para el dueño, y solo "Lectura" para grupo y otros. En número, es 644.
- Para carpetas: Marca "Lectura", "Escritura" y "Ejecución" para el dueño, y solo "Lectura" y "Ejecución" para grupo y otros. En número, es 755.
Aplica los cambios: Haz clic en "Aceptar" o "Guardar". Dependiendo del número de archivos, puede tardar unos segundos.

[TIP] Si solo tienes un error con una carpeta específica (por ejemplo, cache o img), no hace que cambies todos los permisos. Selecciona solo esa carpeta y aplícale 755.

Método 2: Usando SSH (línea de comandos)

Si te sientes cómodo con la terminal y tu hosting permite acceso SSH, este método es más rápido para grandes tiendas.

Conéctate por SSH a tu servidor. Usa un programa como PuTTY (Windows) o la terminal (Mac/Linux).

Navega a la carpeta raíz de PrestaShop:

cd /home/tuusuario/domains/tudominio.com/public_html

Cambia permisos de todas las carpetas a 755:
```
find . -type d -exec chmod 755 {} \;
```
Cambia permisos de todos los archivos a 644:
```
find . -type f -exec chmod 644 {} \;
```
Protege archivos sensibles (como settings.inc.php):
```
chmod 444 config/settings.inc.php
```

[WARNING] No ejecutes estos comandos si no estás seguro de que estás en la carpeta correcta. Podrías romper otros sitios web en el mismo hosting.

Solucionar problemas comunes de permisos en PrestaShop

A veces, incluso con los permisos correctos, los errores persisten. Aquí tienes las soluciones para los casos más frecuentes.

Error: "No se puede escribir en el directorio cache"

Este es uno de los errores más típicos. La carpeta cache necesita permisos especiales porque PrestaShop escribe archivos temporales allí.

Solución:

En DirectAdmin, ve a la carpeta public_html/cache.
Cambia los permisos de toda la carpeta cache y sus subcarpetas a 755.
Si el error persiste, intenta con 777 (pero solo temporalmente, después vuelve a 755).

[INFO] Los permisos 777 permiten que cualquiera escriba en la carpeta. Es inseguro, úsalo solo para probar y luego revierte.

Error: "Permiso denegado" al subir imágenes

PrestaShop guarda las imágenes en public_html/img. Si no puede escribir allí, no podrás subir fotos de productos.

Solución:

Ve a la carpeta img en DirectAdmin.
Cambia sus permisos a 755.
Asegúrate de que el dueño de la carpeta sea el usuario de tu hosting (no root).

Error 500 o página en blanco después de cambiar permisos

Si cambiaste permisos y la tienda dejó de funcionar, probablemente pusiste algún archivo con permisos incorrectos (por ejemplo, 777 en un archivo PHP).

Solución:

Revierte todos los permisos a los valores estándar: archivos 644, carpetas 755.
Si el error sigue, verifica el archivo config/settings.inc.php. Debe tener permisos 444 o 440.
Comprueba el archivo .htaccess (si existe) y asegúrate de que tenga permisos 644.

FAQ: Preguntas frecuentes sobre permisos en PrestaShop

Aquí respondo las dudas más comunes que me llegan como técnico de soporte.

¿Puedo usar permisos 777 en todas las carpetas?

No, es una mala práctica de seguridad. Los permisos 777 permiten que cualquier persona (incluyendo hackers) modifique tus archivos. Úsalos solo temporalmente para solucionar un error y luego revierte.

¿Qué hago si no veo la opción de permisos en DirectAdmin?

Asegúrate de estar en el Administrador de Archivos correcto. Si no aparece el botón, prueba a hacer clic derecho sobre un archivo o carpeta y selecciona "Cambiar permisos" en el menú contextual.

¿Los permisos afectan al rendimiento de mi tienda?

No directamente, pero unos permisos incorrectos pueden causar errores que ralenticen la carga o impidan el funcionamiento de módulos.

¿Cómo sé si el problema es de permisos o de otra cosa?

Los errores típicos de permisos suelen incluir frases como "Permission denied", "Unable to write", "Error 500" o "Cannot create directory". Si ves estos mensajes, empieza por revisar los permisos.

¿Necesito permisos especiales para usar Syspanel?

Si tu hosting usa Syspanel (antes HestiaCP), el acceso es por el puerto 2106. Los pasos para cambiar permisos son similares, pero la interfaz puede variar ligeramente. Busca la opción "Administrador de Archivos" dentro del panel.

Consejos finales para mantener los permisos correctos

Para evitar dolores de cabeza, sigue estas buenas prácticas:

No manipules permisos a menos que sea necesario. Si todo funciona, déjalos como están.
Después de cada actualización de PrestaShop, verifica los permisos. Las actualizaciones a veces los cambian.
Usa un plugin de seguridad que revise los permisos periódicamente.
Si contratas soporte técnico, pide que te expliquen qué permisos han cambiado y por qué.

[TIP] Anota los permisos originales antes de modificarlos. Así, si algo sale mal, puedes restaurarlos fácilmente.

Conclusión

Saber solucionar permisos PrestaShop con DirectAdmin es una habilidad que te ahorrará muchos dolores de cabeza. Recuerda que la clave está en mantener los archivos en 644, las carpetas en 755 y proteger los archivos de configuración. Con los pasos que te he dado, podrás resolver el 90% de los errores de permisos sin necesidad de llamar a un técnico.

Si después de todo esto el error persiste, puede que el problema sea más profundo (como un error en la configuración de PHP o en el propio PrestaShop). En ese caso, no dudes en contactar con tu proveedor de hosting o con un especialista.

¡Espero que esta guía te haya sido útil! Ahora ya sabes cómo domar a tu PrestaShop cuando se pone rebelde con los permisos.