Corregir permisos de archivos en PrestaShop con cPanel | Tutorial

Si alguna vez has visto un mensaje de error en tu tienda PrestaShop que dice algo como “no se puede escribir el archivo”, “permiso denegado” o directamente tu tienda se queda en blanco, es muy probable que estés enfrentando un problema de permisos. No te preocupes, es una de las incidencias más comunes y, con esta guía, la resolverás paso a paso usando cPanel.

Vamos a explicarte qué son los permisos, por qué dan error en PrestaShop y, lo más importante, cómo corregirlos desde cPanel sin necesidad de ser un experto en servidores.

¿Qué son los permisos de archivos y por qué afectan a PrestaShop?

Imagina que tu servidor es un edificio con muchas puertas. Cada archivo y carpeta de tu tienda PrestaShop tiene una puerta con una cerradura que solo permite entrar a ciertas personas: el dueño (tú), el grupo (otros usuarios del servidor) y el público (los visitantes de tu web). Los permisos son las reglas que deciden quién puede leer, escribir o ejecutar cada archivo.

Cuando PrestaShop intenta instalar un módulo, subir una imagen o generar un archivo de caché, necesita “escribir” en ciertas carpetas. Si los permisos no son los correctos, el sistema te lanzará un error de permisos PrestaShop.

¿Por qué ocurre esto?

Al migrar tu tienda de un servidor a otro.
Al restaurar una copia de seguridad.
Al instalar un módulo que modifica archivos del sistema.
Por una configuración incorrecta del hosting.

Identificando el error de permisos en PrestaShop

Antes de actuar, debes saber si realmente es un problema de permisos. Estos son los síntomas más comunes:

Síntomas típicos

Error al subir imágenes o productos: “No se puede escribir en la carpeta /img”.
Problemas al instalar o actualizar módulos: “Error de permisos de archivo”.
La tienda se muestra en blanco o con errores de CSS/JS: Archivos no cargados por falta de permisos de lectura.
Errores en el back office: Mensajes como “Permiso denegado” o “No se puede crear el archivo”.

Si ves alguno de estos, es hora de revisar los permisos.

Accediendo a cPanel para gestionar los permisos

cPanel es la herramienta de gestión de tu hosting. Para empezar:

Inicia sesión en tu cPanel. Normalmente accedes a través de tudominio.com/cpanel o con la URL que te proporcionó tu proveedor de hosting.
Busca la sección “Archivos” (File Manager).
Localiza la carpeta de tu tienda PrestaShop. Suele estar en public_html o www. Si tienes varias webs, busca la carpeta con el nombre de tu dominio.

[TIP] Si usas un panel alternativo como Syspanel (puerto 2106), el proceso es similar: busca el administrador de archivos y localiza la carpeta raíz de tu web.

Cómo corregir permisos de archivos PrestaShop desde cPanel

Ahora vamos a lo práctico. Sigue estos pasos en orden para solucionar el error permisos PrestaShop.

Paso 1: Verificar los permisos actuales

En el administrador de archivos de cPanel, haz clic derecho sobre la carpeta principal de tu PrestaShop (por ejemplo, public_html).
Selecciona “Permisos” o “Change Permissions”.
Verás una ventana con tres columnas: Lectura, Escritura y Ejecución, y tres filas: Propietario, Grupo y Público.

Los valores correctos para PrestaShop son:

Carpetas: 755 (Propietario: rwx, Grupo: r-x, Público: r-x)
Archivos: 644 (Propietario: rw-, Grupo: r--, Público: r--)

Si ves números diferentes, es hora de cambiarlos.

Paso 2: Establecer permisos correctos para toda la instalación

Puedes hacerlo de forma manual carpeta por carpeta, pero es más rápido usando la herramienta de permisos recursivos de cPanel.

En el administrador de archivos, selecciona la carpeta raíz de tu PrestaShop.
En la barra superior, haz clic en “Permisos”.
Marca la casilla “Cambiar permisos de forma recursiva” (recursive).
En “Permisos para directorios”, escribe 755.
En “Permisos para archivos”, escribe 644.
Haz clic en “Cambiar permisos”.

[WARNING] Este proceso puede tardar unos segundos si tienes muchos archivos. No interrumpas la operación.

Paso 3: Ajustar permisos específicos para las carpetas de PrestaShop

PrestaShop necesita permisos de escritura en algunas carpetas para funcionar correctamente. Después del paso anterior, debes dar permisos 755 (o incluso 777 en casos muy específicos) a estas carpetas:

/cache
/config (a veces)
/download
/img
/log
/mails
/modules
/override
/themes (y sus subcarpetas)
/translations
/upload

Para cada una:

Haz clic derecho sobre la carpeta > Permisos.
Cambia a 755 (si no funciona, prueba con 777 temporalmente).
Marca “Cambiar permisos de forma recursiva” si tiene subcarpetas.

[INFO] El permiso 777 permite escritura a cualquiera, lo que puede ser un riesgo de seguridad. Usa 755 siempre que sea posible y solo recurre a 777 si es estrictamente necesario.

Paso 4: Verificar el propietario de los archivos

A veces el problema no son los permisos numéricos, sino que los archivos pertenecen a otro usuario. En cPanel:

Ve a la carpeta raíz de tu PrestaShop.
Haz clic en “Seleccionar todo” (o selecciona archivos específicos).
En el menú superior, busca “Cambiar propietario” (o “Change Owner”).
Asegúrate de que el propietario sea tu usuario de cPanel (el que usas para iniciar sesión).

Si no ves esta opción, contacta con tu hosting, ya que algunos servidores compartidos no permiten cambiar el propietario.

Solucionando errores comunes relacionados con permisos

Error: “No se puede escribir en la carpeta /cache”

Este es uno de los más frecuentes. La solución es:

Ve a la carpeta /cache desde cPanel.
Cambia sus permisos a 755 recursivamente.
Dentro de /cache, busca las subcarpetas /cache/smarty y /cache/smarty/cache y también ponlas a 755.
Si el error persiste, prueba con 777 temporalmente y luego vuelve a 755.

Error al instalar un módulo

Si no puedes instalar módulos, es probable que la carpeta /modules tenga permisos incorrectos.

Localiza la carpeta /modules.
Cambia sus permisos a 755 recursivamente.
Si el módulo que intentas instalar requiere escritura en otras carpetas (como /config o /override), ajusta también esas.

Error de imagen o CSS no cargados

Esto suele ocurrir cuando los archivos de la carpeta /themes no tienen permisos de lectura para el público.

Ve a /themes.
Cambia los permisos de todas las subcarpetas a 755 y archivos a 644.
Si usas un tema personalizado, asegúrate de que la carpeta de tu tema tenga los mismos permisos.

Consejos avanzados para evitar futuros problemas

Usa la herramienta de PrestaShop para verificar permisos

Dentro del back office de tu tienda, ve a Parámetros avanzados > Información y busca la sección “Permisos de archivos”. Te mostrará un listado con el estado de cada carpeta. Si alguna está en rojo, repite los pasos anteriores.

Mantén un backup antes de hacer cambios

Siempre es recomendable tener una copia de seguridad antes de modificar permisos. Puedes hacer una desde cPanel (sección “Backup”) o mediante un plugin de tu hosting.

Configura correctamente el archivo .htaccess

A veces el error de permisos PrestaShop se debe a un .htaccess mal configurado. Puedes regenerarlo desde el back office: Parámetros avanzados > Rendimiento > Regenerar archivo .htaccess.

¿Y si nada funciona? Contacta con tu hosting

Si después de seguir todos los pasos el error persiste, el problema puede estar en la configuración del servidor (por ejemplo, PHP como módulo de Apache o CGI). En ese caso, el soporte técnico de tu hosting (o de Syspanel si usas ese panel) podrá ayudarte a ajustar la configuración de PHP.

Preguntas frecuentes (FAQ)

¿Qué permisos debe tener PrestaShop en cPanel?

Lo estándar es: carpetas 755, archivos 644. Excepciones: carpetas como /cache, /img, /modules y /themes pueden necesitar 755 o 777 temporalmente.

¿Cómo cambiar permisos de archivos en PrestaShop desde cPanel?

Usa el administrador de archivos de cPanel, selecciona la carpeta raíz, haz clic en “Permisos”, marca “recursivo” y establece 755 para directorios y 644 para archivos.

¿Por qué después de cambiar permisos sigue el error?

Puede ser porque el propietario de los archivos no es correcto o porque el servidor tiene una configuración especial (como PHP como CGI). Revisa el propietario y contacta con tu hosting.

¿Es seguro usar permisos 777?

No es recomendable de forma permanente porque cualquiera podría escribir en tu servidor. Úsalo solo temporalmente para solucionar un error y luego vuelve a 755.

¿Puedo usar comandos SSH en lugar de cPanel?

Sí, si tienes acceso SSH, puedes usar comandos como find . -type d -exec chmod 755 {} \; y find . -type f -exec chmod 644 {} \;. Pero cPanel es más amigable para principiantes.

Resumen final

Los problemas de permisos en PrestaShop son molestos pero tienen solución. Con cPanel puedes corregirlos en pocos minutos siguiendo estos pasos:

Identifica el error.
Cambia permisos generales a 755/644.
Ajusta las carpetas especiales.
Verifica el propietario.
Prueba la tienda.

Recuerda que la clave está en ser metódico y no saltarte pasos. Si tienes dudas, vuelve a leer esta guía o consulta con tu proveedor de hosting. ¡Tu tienda volverá a funcionar en poco tiempo!

[TIP] Si usas Syspanel (puerto 2106), el proceso es idéntico: busca el administrador de archivos y aplica los mismos permisos. La única diferencia es la interfaz, pero la lógica es la misma.

Esperamos que esta guía te haya sido útil. Si tienes más preguntas, déjalas en los comentarios o contacta con nuestro equipo de soporte. ¡Buena suerte con tu tienda PrestaShop!