Permisos incorrectos en PrestaShop DirectAdmin | Solución

¡Hola! Soy tu asistente técnico. Si estás leyendo esto, seguramente te has topado con un error molesto en tu tienda PrestaShop, como un mensaje de "error 500", "archivo no encontrado" o que no puedes subir imágenes. No te preocupes, en el 90% de los casos, la solución es corregir los permisos de archivos y carpetas. En esta guía te voy a explicar paso a paso cómo solucionar los problemas de permisos en PrestaShop en DirectAdmin, de una forma sencilla y sin necesidad de ser un experto.

Vamos a desglosar qué son los permisos, por qué son importantes y cómo arreglarlos usando tu panel de control DirectAdmin. Al final, tendrás tu tienda funcionando como nueva. ¡Empecemos!

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

Imagina que tu servidor es un edificio de oficinas. Cada archivo y carpeta de PrestaShop es una puerta con una cerradura. Los permisos son las llaves que determinan quién puede abrir la puerta (el usuario del servidor), quién puede leer lo que hay dentro, quién puede escribir (modificar) y quién puede ejecutar programas.

PrestaShop necesita que ciertos archivos y carpetas tengan unos permisos muy específicos para funcionar. Si estos permisos son demasiado restrictivos (por ejemplo, solo lectura), la tienda no podrá escribir en la base de datos, subir imágenes de productos o generar archivos de caché. Si son demasiado abiertos (por ejemplo, permisos 777), tu sitio puede ser vulnerable a ataques.

Los errores más comunes por error permisos archivos PrestaShop son:

Error 500 Internal Server Error: El servidor no puede ejecutar un archivo porque no tiene permiso.
No se pueden subir imágenes de productos: La carpeta img no tiene permisos de escritura.
El módulo no se instala: La carpeta modules no permite escribir archivos.
La tienda se ve en blanco o con fallos de CSS: Los archivos de caché o de temas no se pueden leer o escribir.
Problemas al actualizar PrestaShop: El sistema no puede sobrescribir archivos antiguos.

En resumen, los permisos PrestaShop DirectAdmin son la causa raíz de muchos dolores de cabeza. Pero con los pasos correctos, se solucionan en minutos.

Requisitos previos antes de empezar a cambiar permisos

Antes de lanzarte a modificar permisos, asegúrate de tener lo siguiente:

Acceso a DirectAdmin: Necesitas tu usuario y contraseña de DirectAdmin (el panel de control de tu hosting). Si no lo tienes, contacta con tu proveedor de hosting.
Conocimiento de la ruta de tu tienda: Normalmente, PrestaShop se instala en una carpeta dentro de public_html (por ejemplo, /home/usuario/domains/tudominio.com/public_html/). En DirectAdmin, puedes verlo en "Gestor de Archivos".
Una copia de seguridad (opcional pero muy recomendable): Si cometes un error, podrías dejar tu tienda inservible. Mejor prevenir que curar. Puedes hacer una copia de seguridad desde DirectAdmin en "Respaldo/Transferencia".
Paciencia: Cambiar permisos de cientos de archivos puede tomar un par de minutos. No interrumpas el proceso.

[WARNING] No cambies permisos a carpetas o archivos del sistema fuera de tu cuenta de hosting (por ejemplo, no toques /etc, /bin). Solo trabaja dentro de tu public_html o la carpeta donde tengas instalado PrestaShop.

Guía paso a paso: Cómo corregir permisos de PrestaShop en DirectAdmin

Aquí te explico el método más seguro y efectivo. No te recomiendo usar chmod 777 a lo loco, ya que es un riesgo de seguridad. En su lugar, usaremos los permisos recomendados por PrestaShop.

Paso 1: Accede al Gestor de Archivos de DirectAdmin

Inicia sesión en tu panel de DirectAdmin.
Busca y haz clic en el icono "Gestor de Archivos" (File Manager). Normalmente está en la sección "Administración de Archivos".
Se abrirá una ventana. Navega hasta la carpeta raíz de tu tienda PrestaShop. Por lo general es: domains/tudominio.com/public_html/ (o simplemente public_html si tu dominio principal está ahí).
Verás todos los archivos y carpetas de tu PrestaShop (carpetas como admin, img, modules, config, etc.).

Paso 2: Selecciona todos los archivos y carpetas

Hay dos formas de hacerlo, dependiendo de si quieres cambiar todo de golpe o por partes.

Opción A: Cambiar permisos de toda la tienda (recomendado para principiantes)

En el Gestor de Archivos, haz clic en la casilla de verificación superior (la que está al lado de "Nombre") para seleccionar todos los archivos y carpetas.
Luego, busca el botón "Permisos" (suele ser un icono de candado o un botón con ese texto). Haz clic en él.
Se abrirá una ventana con opciones de permisos. Aquí es donde debes tener cuidado.

Opción B: Cambiar permisos de carpetas específicas (más seguro)

Si prefieres ser más preciso, puedes seleccionar solo las carpetas problemáticas (como img, modules, config, cache, log, etc.) y luego hacer clic en "Permisos".

Paso 3: Aplicar los permisos correctos para PrestaShop

PrestaShop recomienda la siguiente configuración de permisos para la mayoría de los servidores:

Carpetas: Deben tener permisos 755 (rwxr-xr-x). Esto significa: el propietario puede leer, escribir y ejecutar; el grupo y otros solo pueden leer y ejecutar.
Archivos (no ejecutables): Deben tener permisos 644 (rw-r--r--). El propietario puede leer y escribir; el grupo y otros solo pueden leer.
Archivos de configuración (como config/settings.inc.php): A veces necesitan permisos 644 o 640 para mayor seguridad. Pero para no complicar, usa 644.
Carpetas de escritura temporal (cache, log, img, modules, themes, upload, download, etc.): A veces requieren permisos 755 o incluso 777 temporalmente, pero evita el 777 si es posible. En su lugar, puedes usar 755 y si da error, prueba con 775 (que da escritura al grupo).

[TIP] No uses 777 a menos que sea absolutamente necesario y solo por unos minutos. Si tu proveedor de hosting usa suPHP o FastCGI (lo más común), con 755 suele ser suficiente.

¿Cómo poner estos permisos en DirectAdmin?

En la ventana de "Permisos" que se abrió, verás tres columnas: Propietario (User), Grupo (Group) y Otros (Others). Cada columna tiene tres casillas: Leer (Read), Escribir (Write) y Ejecutar (Execute).

Para carpetas (755): Marca todas las casillas de Propietario (Read, Write, Execute). En Grupo, marca Read y Execute (no Write). En Otros, marca Read y Execute (no Write). Verás que el número se vuelve 755.
Para archivos (644): En Propietario, marca Read y Write (no Execute). En Grupo, solo Read. En Otros, solo Read. El número será 644.

¡Ojo! DirectAdmin te permite aplicar los permisos a todos los archivos y subcarpetas de una sola vez. Busca la opción "Recursivo" o "Aplicar a todos los archivos y subdirectorios" y actívala. Esto es clave para no tener que hacerlo carpeta por carpeta.

Paso 4: Aplicar cambios recursivamente

Una vez que hayas configurado los permisos (por ejemplo, 755 para carpetas), marca la casilla "Recursivo".
Haz clic en "Aceptar" o "Cambiar permisos".
DirectAdmin comenzará a procesar. Esto puede tardar unos segundos o minutos, dependiendo del tamaño de tu tienda.
¡Listo! Los permisos de todas las carpetas se han cambiado a 755.

Pero espera, también necesitas cambiar los permisos de los archivos (no carpetas) a 644.

Paso 5: Cambiar permisos de archivos (no carpetas) a 644

El proceso anterior solo cambió las carpetas. Para los archivos, necesitas hacer otro pase, pero esta vez asegurándote de que solo se aplique a archivos, no a carpetas. Algunos gestores de archivos no permiten hacer esto fácilmente, así que aquí tienes un truco:

En el Gestor de Archivos, haz clic en el icono de "Terminal" o "Ejecutar comandos" (si tu DirectAdmin lo tiene). Si no, puedes usar la opción de "Comandos" en el panel superior.
Si tienes acceso a la terminal, escribe el siguiente comando (reemplaza la ruta con la tuya):

find /home/usuario/domains/tudominio.com/public_html -type f -exec chmod 644 {} \;

Este comando busca todos los archivos (no carpetas) y les asigna permisos 644.

[INFO] Si no tienes acceso a la terminal, no te preocupes. Puedes hacerlo manualmente desde el Gestor de Archivos, seleccionando archivos uno por uno (o usando la búsqueda por tipo). Pero es más tedioso. Otra opción es pedirle a tu soporte de hosting que ejecute el comando por ti.

Paso 6: Permisos especiales para carpetas de escritura

Hay algunas carpetas que PrestaShop necesita para escribir archivos temporalmente. Las más comunes son:

/img
/modules
/themes
/cache
/log
/upload
/download
/translations
/config (a veces)

Para estas carpetas, puedes intentar con 755. Si después de cambiar todo, tu tienda sigue dando error al subir imágenes o instalar módulos, entonces cámbialas a 775 (más permisivo para el grupo) o, como último recurso, a 777 temporalmente.

Para hacerlo:

En el Gestor de Archivos, navega a la carpeta específica (por ejemplo, public_html/img).
Selecciona la carpeta (no entres, solo selecciona la línea).
Haz clic en "Permisos".
Cambia los permisos a 755 (o 775, o 777) y marca Recursivo para que se aplique a todas las subcarpetas y archivos dentro de ella.
Acepta.

[WARNING] Si usas 777 en alguna carpeta, asegúrate de revertirla a 755 o 775 después de solucionar el problema. Dejar permisos 777 permanentemente es un riesgo de seguridad.

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

A veces, el problema no son solo los permisos. Aquí tienes algunas comprobaciones adicionales:

Propietario y grupo incorrectos: En DirectAdmin, el propietario de los archivos suele ser tu usuario de hosting (ej. usuario) y el grupo suele ser usuario o nobody. Si los archivos son propiedad de otro usuario (por ejemplo, root), PrestaShop no podrá escribirlos. Puedes cambiar el propietario desde el Gestor de Archivos (opción "Propietario" o "Cambiar propietario"). Selecciona todos los archivos y asígnalos a tu usuario.
PHP Handler incorrecto: Algunos servidores usan "CGI" o "suPHP" que requieren permisos más estrictos. Otros usan "FastCGI" o "FPM" que son más flexibles. Si tu hosting usa suPHP, los archivos deben ser propiedad de tu usuario (no de nobody). Consulta con tu proveedor.
Archivos de configuración corruptos: Si el error es al acceder al admin, prueba a borrar la carpeta cache/smarty/cache y cache/smarty/compile (no los borres, solo los archivos dentro). Luego, vuelve a cargar la página.
Mod_security o reglas de firewall: A veces, un módulo de seguridad del servidor bloquea ciertas acciones. Si todo lo demás falla, contacta a tu soporte técnico.

Preguntas frecuentes (FAQ) sobre permisos en PrestaShop

¿Cuáles son los permisos correctos para PrestaShop?

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)
Carpetas de escritura (img, modules, cache, etc.): 755 (si falla, prueba 775 o 777 temporalmente).

¿Por qué no debo usar permisos 777 en todo?

Porque cualquier usuario en el servidor (incluyendo posibles atacantes) podría modificar tus archivos. Es como dejar la puerta de tu casa abierta de par en par. Siempre usa el mínimo permiso necesario.

¿Cómo cambio los permisos de un solo archivo en DirectAdmin?

Haz clic derecho sobre el archivo en el Gestor de Archivos y selecciona "Permisos". Cambia los valores manualmente o marca las casillas.

¿Qué hago si no veo la opción "Recursivo" en DirectAdmin?

Algunas versiones de DirectAdmin la tienen oculta. Prueba a seleccionar varios archivos y luego haz clic en "Permisos". A veces aparece. Si no, tendrás que hacerlo carpeta por carpeta o usar la terminal.

¿El error "500 Internal Server Error" siempre es por permisos?

No siempre. Puede ser por un archivo .htaccess mal configurado, un módulo roto o un error de PHP. Pero los permisos son la primera causa a revisar.

¿Mi tienda está en un servidor compartido, debo preocuparme?

Sí, pero menos. En servidores compartidos, el propietario suele ser tu usuario, por lo que los permisos 755 y 644 funcionan bien. Evita el 777 a toda costa.

Conclusión: Tu tienda PrestaShop funcionando sin problemas de permisos

Solucionar los problemas de permisos en PrestaShop en DirectAdmin no es complicado si sigues estos pasos. Recuerda:

Usa 755 para carpetas y 644 para archivos.
Aplica cambios de forma recursiva para ahorrar tiempo.
Solo usa 777 como último recurso y reviértelo después.
Si el error persiste, revisa el propietario de los archivos y el tipo de PHP Handler de tu hosting.

Con esta guía, ya tienes las herramientas para diagnosticar y arreglar los errores más comunes de permisos. Si tienes dudas, no dudes en consultar a tu proveedor de hosting o buscar en la documentación oficial de PrestaShop.

¡Espero que tu tienda vuelva a volar! Si te ha sido útil, compártelo con otros usuarios. ¡Hasta la próxima!