Solucionar error de permisos en PrestaShop | Guía cPanel y Plesk

¿Por qué aparecen errores de permisos en PrestaShop?

Si estás leyendo esto, probablemente has visto mensajes como "No se puede escribir en el archivo", "Error 500 Internal Server", o "No se pudo crear el directorio". No te preocupes, es uno de los problemas más comunes en PrestaShop y tiene solución.

Los permisos de archivos (también conocidos como CHMOD PrestaShop) son las reglas que le indican al servidor quién puede leer, escribir o ejecutar cada archivo y carpeta de tu tienda. Cuando estos permisos están mal configurados, PrestaShop no puede funcionar correctamente.

Vamos a explicarte paso a paso cómo solucionar el error permisos cPanel y también en Plesk, con un lenguaje sencillo y sin tecnicismos innecesarios.

Entendiendo los permisos: la base de todo

Antes de lanzarnos a cambiar permisos, es importante que entiendas qué significan esos números mágicos (644, 755, 775, etc.) que verás en tu panel de hosting.

Cada archivo y carpeta tiene tres grupos de permisos:

Propietario (user): el dueño del archivo, normalmente tu usuario de hosting.
Grupo (group): un conjunto de usuarios que comparten acceso.
Público (public): el resto del mundo (visitantes de tu tienda).

Cada grupo puede tener tres tipos de permiso:

Lectura (r = read): valor 4.
Escritura (w = write): valor 2.
Ejecución (x = execute): valor 1.

Cuando ves un número como 755, significa que el propietario tiene todos los permisos (4+2+1=7), y el grupo y el público solo lectura y ejecución (4+1=5).

[INFO] En PrestaShop, los valores recomendados son 644 para archivos y 755 para carpetas. En algunos casos especiales, como la carpeta de caché o config, se usan 775 o 777 temporalmente.

Preparación antes de cambiar permisos

Haz una copia de seguridad

Este paso es obligatorio. Cambiar permisos de forma incorrecta puede dejar tu tienda inaccesible. Aunque la solución es reversible, es mejor prevenir.

Ve a tu panel de hosting (cPanel o Plesk).
Usa la herramienta de copias de seguridad o el administrador de archivos para descargar una copia completa de tu carpeta public_html (o httpdocs en Plesk).
También exporta tu base de datos desde phpMyAdmin.

[WARNING] Si no haces una copia de seguridad y algo sale mal, podrías perder información de tu tienda. Tómate 10 minutos para hacerlo.

Accede a tu panel de hosting

Dependiendo de tu proveedor, tendrás cPanel o Plesk. En este artículo te mostramos ambos, pero el proceso es similar.

Cómo corregir permisos PrestaShop en cPanel

Paso 1: Inicia sesión en cPanel

Accede a tu cPanel con el usuario y contraseña que te dio tu proveedor de hosting. Normalmente es algo como tudominio.com/cpanel.

Paso 2: Abre el Administrador de Archivos

Busca el icono de Administrador de Archivos (File Manager) en la sección de Archivos.

Se abrirá una ventana. Selecciona la carpeta raíz de tu sitio web (normalmente public_html).
Asegúrate de marcar la casilla "Mostrar archivos ocultos" para ver todos los archivos, incluidos los que empiezan con un punto (como .htaccess).

Paso 3: Selecciona todos los archivos y carpetas

En la parte superior del Administrador de Archivos, haz clic en Seleccionar todo (o usa Ctrl+A).
Verás que todos los archivos y carpetas quedan resaltados.

Paso 4: Cambia los permisos de forma masiva

Con todos los archivos seleccionados, haz clic en el botón Permisos (o Permissions) en la barra superior.
Se abrirá una ventana con casillas de verificación.
Para archivos (todos los que tienen un punto en el nombre, como index.php, config.php):
- Marca las casillas para que queden en 644 (lectura y escritura para propietario; solo lectura para grupo y público).
Para carpetas (las que no tienen extensión, como img, var, config):
- Marca las casillas para que queden en 755 (lectura, escritura y ejecución para propietario; lectura y ejecución para grupo y público).

[TIP] Si el Administrador de Archivos te permite escribir el número directamente, escribe 644 para archivos y 755 para carpetas. Es mucho más rápido.

Paso 5: Aplica los cambios

Haz clic en Cambiar permisos (o Change Permissions).
PrestaShop ahora debería tener los permisos base correctos.

Paso 6: Permisos especiales para carpetas críticas

Algunas carpetas de PrestaShop necesitan permisos de escritura para que la tienda funcione correctamente (por ejemplo, para subir imágenes, generar caché o instalar módulos). Estas son:

/cache
/log
/img
/var
/config
/translations
/upload
/download

Para estas carpetas, cambia los permisos a 775 (el propietario y el grupo pueden escribir).

Entra en cada carpeta, selecciona todos los archivos dentro y cambia los permisos a 664 para archivos y 775 para subcarpetas.

[WARNING] No uses permisos 777 de forma permanente. Aunque solucionan el error, dejan tu tienda vulnerable a ataques. Úsalos solo temporalmente y vuelve a 775 o 755 después.

Paso 7: Verifica que el error ha desaparecido

Ve a tu tienda PrestaShop y recarga la página.
Si el error persiste, prueba a vaciar la caché de PrestaShop desde el panel de administración (Parámetros avanzados > Rendimiento > Vaciar caché).

Cómo corregir permisos PrestaShop en Plesk

Paso 1: Inicia sesión en Plesk

Accede a tu panel de Plesk. Normalmente es tudominio.com:8443 o la URL que te dio tu proveedor.

Paso 2: Abre el Administrador de Archivos

En el menú lateral, busca Sitios web y dominios.
Haz clic en Administrador de archivos (File Manager) en la fila de tu dominio.

Paso 3: Selecciona la carpeta raíz

Ve a la carpeta httpdocs (es el equivalente a public_html en cPanel).
Marca la casilla de Mostrar archivos ocultos si es necesario.

Paso 4: Cambia los permisos de archivos

Selecciona todos los archivos (Ctrl+A).
Haz clic en el botón Permisos en la barra superior.
Verás una tabla con los permisos actuales.
Para archivos, introduce 644 en el campo de permisos numéricos.
Para carpetas, introduce 755.

[INFO] En Plesk, si tienes acceso SSH, también puedes usar el comando chmod 644 archivo.php y chmod 755 carpeta. Pero el Administrador de Archivos es más visual y seguro para principiantes.

Paso 5: Permisos especiales en Plesk

Al igual que en cPanel, las carpetas críticas (cache, img, var, config, etc.) necesitan permisos de escritura.

Entra en cada carpeta.
Selecciona todos los archivos dentro.
Cambia los permisos a 664 para archivos y 775 para subcarpetas.

Paso 6: Borra la caché

Ve a tu panel de administración de PrestaShop.
En Parámetros avanzados > Rendimiento, haz clic en Vaciar caché.
También puedes borrar manualmente el contenido de /var/cache y /cache (excepto el archivo .htaccess si existe).

Método avanzado: Usar un script de reparación automática

Si no quieres cambiar permisos uno a uno, existe una solución mucho más rápida. Puedes crear un pequeño script PHP que haga el trabajo por ti.

Crea un archivo `fix_permissions.php`

Ve a la raíz de tu tienda (donde está index.php).
Crea un archivo llamado fix_permissions.php.
Pega este código:

<?php
// Script para corregir permisos de PrestaShop
$dir = __DIR__;
$it = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
    RecursiveIteratorIterator::SELF_FIRST
);
foreach ($it as $item) {
    if ($item->isDir()) {
        chmod($item->getPathname(), 0755);
    } else {
        chmod($item->getPathname(), 0644);
    }
}
echo "Permisos corregidos correctamente.";

Guarda el archivo.
Accede a tudominio.com/fix_permissions.php en tu navegador.
Verás el mensaje de confirmación.
IMPORTANTE: Borra el archivo inmediatamente después de usarlo. Es un riesgo de seguridad dejarlo en tu servidor.

[WARNING] Este script cambia todos los permisos a 644/755. Después, tendrás que cambiar manualmente las carpetas críticas a 775 (como se explicó antes). No uses este método si no sabes lo que estás haciendo.

Errores comunes y sus soluciones específicas

Error: "No se puede escribir en el archivo config/settings.inc.php"

Este es uno de los errores de permisos PrestaShop más frecuentes, sobre todo al instalar módulos.

Solución:

Cambia los permisos de /config/settings.inc.php a 777 temporalmente.
Realiza la operación que necesites (instalar módulo, actualizar, etc.).
Vuelve a cambiar los permisos a 644 inmediatamente.

Error: "La carpeta /cache no se puede escribir"

Suele aparecer cuando la caché no se puede generar.

Solución:

Cambia los permisos de /cache y /var/cache a 775.
Asegúrate de que el propietario de la carpeta sea tu usuario de hosting (no root).
Vacía la caché desde el panel de administración.

Error: "No se puede subir la imagen"

Solución:

Cambia los permisos de /img a 775.
Si el error persiste, crea la subcarpeta que falta (por ejemplo, /img/p para productos) y dale permisos 755.

Consejos finales para mantener los permisos correctos

No uses 777 de forma permanente: es la puerta de entrada para hackers.
Revisa los permisos después de cada actualización: las actualizaciones de PrestaShop o de módulos pueden cambiar los permisos.
Usa FTP con permisos explícitos: si usas FileZilla, configura los permisos por defecto en 644 para archivos y 755 para carpetas.
Si usas Syspanel (HestiaCP): el acceso es por el puerto 2106 y el proceso es similar al de cPanel, pero con la interfaz de Syspanel. Busca "Administrador de archivos" en el menú.

[TIP] Si después de todo esto el error persiste, el problema puede ser del propietario de los archivos. Asegúrate de que todos los archivos pertenezcan a tu usuario de hosting y no a root. En cPanel puedes verificar esto en el Administrador de Archivos (columna "Propietario").

Preguntas frecuentes (FAQ)

¿Qué permisos debe tener PrestaShop para funcionar?

Los permisos estándar son 644 para archivos y 755 para carpetas. Las carpetas de caché, imágenes y config pueden necesitar 775.

¿Qué significa CHMOD en PrestaShop?

CHMOD es el comando que cambia los permisos de archivos en sistemas Unix/Linux. En PrestaShop, se usa para dar permisos de lectura, escritura y ejecución a archivos y carpetas.

¿Puedo usar permisos 777 para solucionar el error de permisos cPanel?

Sí, pero solo temporalmente. Los permisos 777 permiten que cualquier usuario escriba en el archivo o carpeta, lo que es un riesgo de seguridad. Cámbialos de vuelta a 755/644 después de solucionar el problema.

¿Cómo sé qué carpeta tiene permisos incorrectos?

Activa el modo depuración de PrestaShop (en /config/defines.inc.php, cambia _PS_MODE_DEV_ a true). El error te dirá exactamente qué archivo o carpeta tiene problemas.

¿Qué hago si no tengo acceso al panel de administración?

Puedes cambiar los permisos directamente desde el Administrador de Archivos de cPanel o Plesk, como te hemos explicado. Si no tienes acceso ni a eso, contacta con tu proveedor de hosting.

Resumen final

Los errores de permisos en PrestaShop son molestos pero muy fáciles de solucionar si sigues estos pasos:

Haz una copia de seguridad.
Accede al Administrador de Archivos de tu panel (cPanel, Plesk o Syspanel en el puerto 2106).
Cambia archivos a 644 y carpetas a 755.
Da permisos especiales 775 a las carpetas críticas (cache, img, var, config).
Vacía la caché y comprueba que todo funciona.

Si has llegado hasta aquí, ya tienes todo lo necesario para resolver el error permisos cPanel o en Plesk. Recuerda que la paciencia es clave y que siempre puedes volver a intentarlo si algo sale mal.

[INFO] Si el problema persiste después de seguir todos los pasos, puede que el error no sea de permisos. Revisa los logs de error de tu servidor (en cPanel: "Registros de errores"; en Plesk: "Logs") para obtener más pistas.

¡Mucha suerte con tu tienda PrestaShop!

¿Por qué aparecen errores de permisos en PrestaShop?

Entendiendo los permisos: la base de todo

Preparación antes de cambiar permisos

Haz una copia de seguridad

Accede a tu panel de hosting

Cómo corregir permisos PrestaShop en cPanel

Paso 1: Inicia sesión en cPanel

Paso 2: Abre el Administrador de Archivos

Paso 3: Selecciona todos los archivos y carpetas

Paso 4: Cambia los permisos de forma masiva

Paso 5: Aplica los cambios

Paso 6: Permisos especiales para carpetas críticas

Paso 7: Verifica que el error ha desaparecido

Cómo corregir permisos PrestaShop en Plesk

Paso 1: Inicia sesión en Plesk

Paso 2: Abre el Administrador de Archivos

Paso 3: Selecciona la carpeta raíz

Paso 4: Cambia los permisos de archivos

Paso 5: Permisos especiales en Plesk

Paso 6: Borra la caché

Método avanzado: Usar un script de reparación automática

Crea un archivo fix_permissions.php

Errores comunes y sus soluciones específicas

Error: "No se puede escribir en el archivo config/settings.inc.php"

Error: "La carpeta /cache no se puede escribir"

Error: "No se puede subir la imagen"

Consejos finales para mantener los permisos correctos

Preguntas frecuentes (FAQ)

¿Qué permisos debe tener PrestaShop para funcionar?

¿Qué significa CHMOD en PrestaShop?

¿Puedo usar permisos 777 para solucionar el error de permisos cPanel?

¿Cómo sé qué carpeta tiene permisos incorrectos?

¿Qué hago si no tengo acceso al panel de administración?

Resumen final

Crea un archivo `fix_permissions.php`