Solucionar errores de permisos en PrestaShop con DirectAdmin

¿Por qué mi PrestaShop muestra errores de permisos?

Si estás gestionando una tienda online con PrestaShop y de repente ves mensajes como "Error 500", "No se puede escribir en la carpeta cache", o "Permiso denegado al mover archivos", no te preocupes. Es muy probable que estés ante un problema común: errores de permisos en los archivos y carpetas de PrestaShop.

Estos errores suelen aparecer después de migrar la tienda, instalar un módulo, actualizar la versión de PrestaShop o al cambiar de servidor. La causa principal es que los archivos de tu tienda no tienen los permisos correctos para que el servidor web (Apache o Nginx) pueda leerlos, escribirlos o ejecutarlos.

En este artículo te explicaré de forma clara y paso a paso cómo identificar y arreglar los errores de permisos en PrestaShop usando DirectAdmin, el panel de control de hosting que probablemente tengas contratado.

¿Qué son exactamente los permisos de archivos?

Imagina que tu servidor es un edificio con varias habitaciones (carpetas) y archivos (documentos). Cada uno tiene un candado que permite o deniega el acceso según quién quiera entrar:

Propietario (Owner): El dueño de la tienda (tú).
Grupo (Group): Un grupo de usuarios (por ejemplo, el servidor web).
Público (Public): Cualquier visitante de tu web.

Los permisos se representan con tres dígitos (por ejemplo, 755, 644, 777) y cada dígito indica qué puede hacer cada tipo de usuario:

7 = Lectura + Escritura + Ejecución (permiso total)
6 = Lectura + Escritura
5 = Lectura + Ejecución
4 = Solo lectura
0 = Sin permisos

Para PrestaShop, la configuración estándar es:

Carpetas: 755 (el propietario tiene control total, el grupo y público solo pueden leer y ejecutar).
Archivos: 644 (el propietario puede leer y escribir, el grupo y público solo leer).

Si algún archivo o carpeta tiene permisos incorrectos (por ejemplo, 777 en un archivo que debería ser 644), tu tienda puede fallar o volverse insegura.

¿Cómo saber si tengo un error de permisos en PrestaShop?

Los síntomas más comunes son:

Error 500 Internal Server Error al acceder a cualquier página.
Mensajes en el back office como "No se puede escribir en la carpeta /cache" o "El archivo .htaccess no se puede modificar".
Problemas al instalar o actualizar módulos: el proceso se queda colgado o da error.
Imágenes que no se cargan (especialmente después de subir productos).
Errores al generar el archivo .htaccess desde la configuración de SEO y URL.

Si ves alguno de estos síntomas, es muy probable que necesites arreglar los permisos de PrestaShop.

Paso a paso: Cómo arreglar permisos en PrestaShop usando DirectAdmin

Vamos a resolverlo. DirectAdmin es un panel de control de hosting muy intuitivo. Sigue estos pasos al pie de la letra:

1. Accede a DirectAdmin

Ingresa a tu panel de control. Normalmente la URL es algo como https://tudominio.com:2222 o https://ipdelservidor:2222. Introduce tu usuario y contraseña (los mismos que usas para acceder a tu hosting).

2. Localiza el administrador de archivos

Dentro de DirectAdmin, busca la sección "Administrador de Archivos" (File Manager). Haz clic en ella. Se abrirá una ventana con la estructura de carpetas de tu cuenta de hosting.

3. Navega hasta la carpeta raíz de tu PrestaShop

Dentro del administrador de archivos, busca la carpeta donde está instalado PrestaShop. Normalmente es public_html o domains/tudominio.com/public_html. Haz clic para entrar.

Verás todas las carpetas y archivos de tu tienda: cache, img, modules, config, etc.

4. Selecciona todos los archivos y carpetas

En la parte superior del administrador de archivos suele haber un checkbox para seleccionar todo. Márcalo. Si no, puedes hacer clic en el primer elemento, mantener presionada la tecla Shift y hacer clic en el último para seleccionar un rango.

5. Cambia los permisos a 755 (carpetas) y 644 (archivos)

Una vez seleccionados todos los elementos, busca el botón "Permisos" o "Change Permissions" (suele estar en la barra de herramientas). Aparecerá una ventana con tres casillas para el propietario, el grupo y el público.

Importante: No puedes cambiar todos los archivos a la vez con un solo clic, porque las carpetas deben tener permisos diferentes a los archivos. DirectAdmin te permite hacerlo de forma inteligente:

En la ventana de permisos, verás una opción que dice "Recursivo" o "Apply to all subdirectories and files". Márcala.
Luego, en los campos numéricos, escribe 755 para las carpetas y 644 para los archivos. Algunos paneles tienen dos campos separados: uno para directorios y otro para archivos. Si no, puedes hacerlo en dos pasos:
1. Primero cambia todo a 755 (esto afecta a carpetas y archivos, pero luego corregiremos los archivos).
2. Luego, selecciona solo los archivos (puedes filtrar por tipo) y cámbialos a 644.

Método más seguro: Si tu versión de DirectAdmin lo permite, usa la opción "Set permissions for directories to 755 and files to 644" (a veces aparece como un botón directo). Si no, hazlo manualmente:

Haz clic en "Cambiar permisos".
En "Permisos", escribe 755.
Marca "Recursivo".
Haz clic en "Aceptar".
Luego, repite el proceso pero escribiendo 644 y asegurándote de que solo afecte a archivos (algunos paneles permiten elegir "solo archivos" en un desplegable).

[TIP] Si ves que el proceso se queda pegado o da error, no te preocupes. Puedes hacerlo por partes: primero las carpetas principales (cache, img, modules, etc.) y luego los archivos.

6. Verifica que los permisos se hayan aplicado correctamente

Para comprobarlo, haz clic derecho sobre cualquier carpeta y selecciona "Permisos". Debería mostrar 755 (rwx r-x r-x). Haz lo mismo con un archivo (por ejemplo, index.php) y debería mostrar 644 (rw- r-- r--).

¿Qué hacer si el error persiste?

A veces, aunque los permisos de archivos estén correctos, el problema está en el propietario de los archivos. En DirectAdmin, los archivos deben pertenecer al usuario de tu cuenta de hosting (normalmente el mismo nombre que tu usuario de DirectAdmin). Si por error los archivos pertenecen a otro usuario (por ejemplo, "nobody" o "www-data"), PrestaShop no podrá escribir en ellos.

Cómo cambiar el propietario de los archivos en DirectAdmin

En el administrador de archivos, selecciona todos los archivos y carpetas (igual que antes).
Busca el botón "Propietario" o "Change Owner".
En la ventana, selecciona tu nombre de usuario (el que usas para entrar a DirectAdmin). Si aparece "nobody" o "www-data", cámbialo a tu usuario.
Marca "Recursivo" para que se aplique a todas las subcarpetas.
Haz clic en "Aceptar".

[WARNING] No cambies el propietario a "nobody" o "www-data" a menos que sepas exactamente lo que haces. Si lo haces, podrías perder el acceso a tus archivos desde el FTP o el administrador de archivos.

Casos especiales: módulos, caché y archivos temporales

Algunas carpetas de PrestaShop necesitan permisos especiales para funcionar correctamente. Por ejemplo:

/cache y /img: Deben tener permisos 755 y pertenecer a tu usuario. Si los módulos de imagen no generan miniaturas, prueba a dar permisos 777 temporalmente a la carpeta /img/tmp y luego vuelve a 755.
/config: Debe ser 755. Si el archivo /config/settings.inc.php tiene permisos 644, es correcto. Si algún módulo no puede escribir, cámbialo a 644 (nunca 777).
/modules: Cada carpeta de módulo debe tener 755 y los archivos 644. Si un módulo da error, revisa sus permisos específicos.
/themes: Igual que modules, 755 para carpetas y 644 para archivos.
/override: Si usas sobrescrituras, deben tener permisos 755 en carpetas y 644 en archivos.

[INFO] Si después de todo sigue sin funcionar, revisa el archivo /config/defines.inc.php y busca la línea define('_PS_MODE_DEV_', false);. Cámbiala a true para ver mensajes de error más detallados. Luego, vuelve a ponerla en false cuando termines.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop da error de permisos después de una actualización?

Al actualizar, los nuevos archivos pueden tener permisos incorrectos o el proceso de actualización puede cambiar el propietario. Simplemente repite los pasos anteriores: cambia permisos a 755/644 y verifica el propietario.

¿Es seguro dar permisos 777 a alguna carpeta?

No, nunca. 777 significa que cualquiera puede leer, escribir y ejecutar. Es un grave riesgo de seguridad. Si una carpeta necesita permisos de escritura temporal, usa 777 solo durante unos minutos y luego vuelve a 755.

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

En algunas versiones de DirectAdmin, la opción de permisos está dentro del menú contextual (clic derecho) o en la barra superior. Si no aparece, contacta con tu proveedor de hosting para que te habilite el acceso.

¿Puedo arreglar los permisos desde el FTP?

Sí, pero es más lento. Conecta con un cliente FTP (como FileZilla), selecciona todos los archivos, haz clic derecho y elige "Permisos de archivo". Luego, marca "Recursivo en subdirectorios" y escribe 755 para carpetas y 644 para archivos.

¿Los errores de permisos pueden afectar al SEO de mi tienda?

Indirectamente, sí. Si los errores impiden que se generen las páginas correctamente, los motores de búsqueda pueden encontrar errores 500 o páginas rotas, lo que perjudica tu posicionamiento. Además, si no se pueden generar los archivos .htaccess o robots.txt, el SEO se ve afectado.

Consejo final: Mantén tus permisos siempre correctos

Para evitar futuros problemas, te recomiendo:

Haz copias de seguridad periódicas de los archivos y la base de datos.
Después de cada actualización o instalación de módulo, verifica los permisos.
Usa siempre el panel de control (DirectAdmin) para gestionar los archivos, no FTP, porque a veces el FTP cambia los permisos sin que te des cuenta.
Si usas Syspanel (el antiguo HestiaCP), recuerda que el puerto de acceso es el 2106 y los pasos son similares: busca el administrador de archivos y aplica los mismos permisos.

Si sigues estos pasos, tu PrestaShop volverá a funcionar sin problemas. Recuerda que los errores de permisos en PrestaShop son comunes pero fáciles de solucionar con las herramientas adecuadas. ¡Manos a la obra!