Cómo arreglar permisos de archivos en PrestaShop | Guía multiplataforma

¡Hola! Si estás leyendo esto, probablemente tu tienda PrestaShop te está mostrando algún error extraño, como que no puedes subir imágenes, que las hojas de estilo (CSS) no cargan, o que ves un mensaje de "Error 500" o "Archivo no encontrado". En la gran mayoría de los casos, la raíz del problema está en los permisos de archivos y carpetas.

No te preocupes, es un problema muy común y, sobre todo, soluble. En esta guía extensa y detallada, te explicaré paso a paso cómo solucionar los problemas de permisos PrestaShop en los paneles de control más habituales: cPanel, Plesk y DirectAdmin. También veremos cómo usar el comando chmod PrestaShop para ajustar los permisos correctos.

Vamos a desglosarlo de forma sencilla, como si estuviéramos tomando un café y te lo explicara un amigo técnico.

¿Por qué ocurren los errores de permisos en PrestaShop?

Imagina que tu servidor es un edificio de oficinas. Cada archivo y carpeta de tu tienda PrestaShop es una oficina con una puerta. Los permisos son las reglas que deciden quién puede abrir la puerta, quién puede leer los documentos que hay dentro y quién puede tirar cosas a la basura.

En PrestaShop, hay dos "personajes" principales que necesitan acceso:

El Propietario (Dueño del archivo): Normalmente, eres tú (tu usuario de hosting).
El Servidor Web (Apache/Nginx): Es el programa que muestra tu tienda a los visitantes. Necesita poder leer archivos (para mostrar la web) y escribir en ciertas carpetas (para subir imágenes de productos, generar archivos de caché, etc.).

Cuando los permisos PrestaShop están mal configurados, el servidor web no puede hacer su trabajo, y aparecen los molestos errores permisos PrestaShop.

Los Permisos Correctos para PrestaShop (La "Receta Mágica")

Antes de meternos en cada panel, esta es la configuración de permisos que PrestaShop necesita para funcionar correctamente. Es lo que llamaremos la "configuración segura".

Carpetas (Directorios): Permiso 755.
- El propietario puede leer, escribir y ejecutar (entrar).
- El grupo y otros solo pueden leer y ejecutar (entrar).
Archivos (Ficheros): Permiso 644.
- El propietario puede leer y escribir.
- El grupo y otros solo pueden leer.
Carpetas Especiales (para caché, uploads, etc.): Permiso 755.
- Hay carpetas como /cache, /upload, /img, /config, /themes, /override, /mails, /modules, /translations y la raíz / donde PrestaShop necesita escribir temporalmente. El permiso 755 es suficiente para que el servidor web pueda escribir en ellas si el propietario es correcto.

[WARNING] ¡Cuidado con el 777!
Es muy tentador poner todos los permisos a 777 ("todos pueden hacer de todo") para que los errores desaparezcan rápido. NO LO HAGAS. Es un gravísimo riesgo de seguridad. Cualquier persona o script malicioso podría modificar o borrar tu tienda. Usa siempre 755 y 644.

Solucionar problemas en cPanel

cPanel es uno de los paneles más populares. Vamos a ver cómo arreglar los permisos desde su interfaz gráfica.

Paso 1: Accede al Administrador de Archivos

Inicia sesión en tu cPanel.
Busca la sección "Archivos" y haz clic en "Administrador de Archivos".
Se te pedirá que selecciones el directorio raíz. Elige la opción que corresponda a tu dominio (normalmente public_html o www) y haz clic en "Ir".

Paso 2: Selecciona y cambia los permisos de las carpetas

Una vez dentro de la carpeta de tu tienda (por ejemplo, public_html), marca la casilla de la carpeta raíz de PrestaShop (la que contiene index.php, config/, img/, etc.).
Haz clic en el botón "Permisos" en la barra de herramientas superior.
Se abrirá una ventana. Verás una serie de casillas de verificación agrupadas en tres columnas: Lectura, Escritura y Ejecución para Usuario, Grupo y Público.
Para configurar el permiso 755, asegúrate de que estén marcadas así:
- Usuario: Lectura, Escritura y Ejecución.
- Grupo: Lectura y Ejecución.
- Público: Lectura y Ejecución.
Importante: Marca la casilla "Cambiar los permisos a todos los archivos y carpetas dentro" (o similar, como "Recursivo").
Haz clic en "Cambiar permisos". Esto establecerá 755 en TODAS las carpetas y TODOS los archivos. No te preocupes, luego arreglaremos los archivos.

Paso 3: Cambia los permisos de los archivos a 644

Ahora, en el Administrador de Archivos, haz clic en el botón "Configuración" (arriba a la derecha, un icono de engranaje).
Marca la opción "Mostrar archivos ocultos (puntos)" y haz clic en "Guardar". Esto es necesario para ver archivos importantes como .htaccess.
Vuelve a la raíz de tu tienda. En la barra de búsqueda (o en el campo "Ir a la carpeta"), escribe *.* y presiona Enter. Esto mostrará todos los archivos.
Selecciona todos los archivos (puedes usar Ctrl+E o el botón "Seleccionar todo").
Haz clic en "Permisos" de nuevo.
Configura el permiso 644:
- Usuario: Lectura y Escritura.
- Grupo: Lectura.
- Público: Lectura.
Asegúrate de que la casilla "Cambiar los permisos a todos los archivos y carpetas dentro" NO esté marcada (solo queremos cambiar archivos, no las carpetas que ya configuramos).
Haz clic en "Cambiar permisos".

¡Listo! Con esto, las carpetas tendrán 755 y los archivos 644. Si aún tienes problemas, repite el proceso pero asegurándote de que el propietario de los archivos sea tu usuario de cPanel.

Solucionar problemas en Plesk

Plesk es otro panel muy común, especialmente en servidores Windows y algunos Linux. El proceso es ligeramente diferente.

Paso 1: Accede al Administrador de Archivos

Inicia sesión en Plesk.
Ve a "Sitios web y dominios".
Busca el dominio de tu tienda y haz clic en "Administrador de Archivos" (normalmente tiene un icono de carpeta).

Paso 2: Cambia los permisos de forma recursiva

Plesk no tiene un botón directo para cambiar permisos de archivos y carpetas por separado de forma masiva como cPanel. La forma más fácil es usar la opción de "Cambiar permisos" en la carpeta raíz.

En el Administrador de Archivos de Plesk, navega hasta la carpeta raíz de tu PrestaShop.
Marca la casilla de la carpeta principal (la que contiene todos los archivos de PrestaShop).
Haz clic en el botón "Cambiar permisos" en la barra de herramientas.
Se abrirá una ventana. Plesk te permite elegir entre "Establecer permisos para archivos" y "Establecer permisos para directorios" por separado.
Para directorios: Configura el permiso en 755 y selecciona "Aplicar a todos los subdirectorios".
Haz clic en "Aceptar".
Vuelve a la raíz, selecciona la carpeta principal de nuevo y haz clic en "Cambiar permisos" otra vez.
Para archivos: Configura el permiso en 644 y selecciona "Aplicar a todos los archivos". Asegúrate de no seleccionar "Aplicar a subdirectorios" (si existe esa opción, a veces viene implícita).
Haz clic en "Aceptar".

[TIP] Si Plesk no tiene la opción por separado
Algunas versiones de Plesk solo permiten un cambio masivo. En ese caso, cambia toda la carpeta a 755 primero y luego, uno por uno (o por SSH si te animas), cambia los archivos a 644. Otra opción es usar un módulo o script desde el propio panel.

Solucionar problemas en DirectAdmin

DirectAdmin es conocido por su simplicidad y eficiencia. El proceso es muy similar a cPanel.

Paso 1: Accede al Administrador de Archivos

Inicia sesión en tu DirectAdmin.
Haz clic en el icono de "Administrador de Archivos" en la sección "Administración de Cuentas".

Paso 2: Cambia los permisos de forma recursiva

Navega hasta la carpeta donde está instalado PrestaShop (normalmente domains/tudominio.com/public_html).
Marca la casilla de la carpeta raíz de tu tienda.
En la barra de herramientas superior, haz clic en el botón "Permisos".
Se abrirá una ventana. Verás un campo de texto para el número de permiso (octal) y una opción de "Recursivo".
Primero, para las carpetas: Escribe 755 en el campo de texto. IMPORTANTE: Marca la casilla "Recursivo".
Haz clic en "Aceptar". Esto cambiará todo (archivos y carpetas) a 755.
Ahora, arreglamos los archivos: Vuelve a la raíz. En la barra de direcciones del Administrador de Archivos, a menudo hay un botón o enlace para "Seleccionar todos los archivos" o puedes hacerlo manualmente.
Una vez seleccionados todos los archivos (no las carpetas), haz clic en "Permisos" de nuevo.
Escribe 644 en el campo de texto.
Asegúrate de que la casilla "Recursivo" NO esté marcada (para que solo cambie los archivos seleccionados, no las subcarpetas).
Haz clic en "Aceptar".

¡Perfecto! Tu tienda ya debería tener los permisos correctos.

Solucionar problemas en Syspanel (anteriormente HestiaCP)

Si tu hosting usa Syspanel, el proceso es un poco diferente, ya que su administrador de archivos web es más básico. Para cambios masivos, la opción más fiable es usar el acceso SSH o un comando desde el propio panel.

[INFO] Acceso a Syspanel
Recuerda que para acceder a Syspanel, debes ir a https://tudominio.com:2106 (el puerto es el 2106).

Opción 1: Usando el Administrador de Archivos de Syspanel (para cambios pequeños)

Inicia sesión en Syspanel.
Ve a "Web" y luego a "Administrador de Archivos".
Navega hasta la carpeta de tu dominio (ej: web/tudominio.com/public_html).
Puedes cambiar permisos de archivos uno por uno haciendo clic derecho sobre ellos y seleccionando "Permisos". Es tedioso, pero funciona para un par de archivos.

Opción 2: Usando el comando desde el Panel (Recomendado para cambios masivos)

Syspanel tiene una sección para ejecutar comandos.

En Syspanel, ve a "Web" y luego haz clic en "Editar" (el lápiz) al lado de tu dominio.
Busca una pestaña o sección que diga "Comandos" o "Ejecutar comando".
Escribe el siguiente comando mágico en una sola línea y haz clic en "Ejecutar":

find /home/usuario/web/tudominio.com/public_html -type d -exec chmod 755 {} \; && find /home/usuario/web/tudominio.com/public_html -type f -exec chmod 644 {} \;

Importante: Reemplaza /home/usuario/web/tudominio.com/public_html con la ruta real de tu tienda. Puedes saber la ruta exacta mirando la configuración del dominio en Syspanel.

Este comando hace todo el trabajo sucio en un solo paso:

Busca todas las carpetas (-type d) y les asigna 755.
Busca todos los archivos (-type f) y les asigna 644.

[TIP] ¿No funciona el comando?
Si el panel no te deja ejecutar comandos o te da error, deberás contactar con tu soporte técnico y pedirles que ejecuten ese comando por ti. Es la forma más segura y rápida.

Preguntas Frecuentes (FAQ) sobre Errores de Permisos en PrestaShop

P: He cambiado los permisos a 755 y 644, pero sigo viendo un error 500. ¿Qué hago?

R: El error 500 puede tener muchas causas. Después de los permisos, lo siguiente más común es:

Archivo .htaccess corrupto: Renómbralo a .htaccess_old y ve si la web carga (aunque sin URLs amigables). Si funciona, genera uno nuevo desde el panel de administración de PrestaShop (Parámetros de la Tienda > Tráfico y SEO > Configurar URLs amigables).
PHP Memory Limit: A veces el límite de memoria de PHP es muy bajo. Puedes aumentarlo desde el panel de control (Seleccionar versión de PHP > Opciones > memory_limit) o pidiéndole a tu hosting que lo suba a 256MB o 512MB.
Módulo conflictivo: Desactiva módulos recién instalados renombrando la carpeta del módulo en /modules (ej: /modules/mimodulo a /modules/mimodulo_old).

P: ¿Puedo usar un plugin o módulo de PrestaShop para arreglar los permisos?

R: Sí, existen módulos en el marketplace de PrestaShop que se encargan de esto, pero son de pago. La forma manual que te hemos explicado es gratuita y 100% efectiva. Además, así aprendes cómo funciona tu tienda por dentro.

P: ¿Cada cuánto tiempo debo revisar los permisos?

R: No es necesario que los revises constantemente. Normalmente, solo se desconfiguran si:

Instalaste un módulo o tema de forma incorrecta.
Alguien (o un script) modificó los permisos manualmente.
Después de una migración de servidor.
Al actualizar la versión de PrestaShop.

Si no haces nada de esto, los permisos deberían mantenerse correctos.

P: ¿Qué significa "chmod 777" y por qué es peligroso?

R: chmod es el comando para cambiar permisos en Linux. El número 777 significa que el Usuario (7), el Grupo (7) y Público (7) tienen permisos totales de Lectura (4), Escritura (2) y Ejecución (1) (4+2+1=7). Es peligroso porque cualquier persona en internet podría, en teoría, modificar o eliminar archivos de tu tienda si encuentra una vulnerabilidad. Es como dejar la puerta de tu casa abierta de par en par.

P: Mi hosting usa Syspanel. ¿El puerto de acceso es el mismo?

R: Sí, como indicamos antes, el acceso a Syspanel se realiza a través del puerto 2106. Por ejemplo: https://tudominio.com:2106.