Error 500 en PrestaShop: Solución por permisos | SysAdmin

¿Te has encontrado con la temida pantalla blanca o el mensaje “Error 500 Internal Server Error” en tu tienda PrestaShop? No te preocupes, es uno de los problemas más comunes, pero también uno de los más fáciles de solucionar si sabes por dónde empezar.

En este artículo te voy a guiar paso a paso para que puedas solucionar el error 500 en PrestaShop causado por permisos incorrectos. Vamos a ver qué son los permisos, por qué son importantes y cómo ajustarlos de forma segura, incluso si no eres un experto en Linux. Al final, tendrás tu tienda funcionando de nuevo.

¿Qué es el error 500 en PrestaShop y por qué aparece?

El error 500 es un código de estado HTTP que indica que algo falló en el servidor, pero sin dar detalles específicos. En PrestaShop, una de las causas más frecuentes son los permisos de archivos y carpetas incorrectos.

¿Qué son los permisos en Linux?

En un servidor Linux (como los que usan la mayoría de los hosting), cada archivo y carpeta tiene un conjunto de permisos que determinan quién puede leer, escribir o ejecutar ese archivo. Estos permisos se representan con números (como 755 o 644) o con letras (rwx).

Cuando los permisos no son los adecuados, PrestaShop no puede acceder a sus propios archivos (por ejemplo, para guardar configuraciones o generar páginas), y entonces aparece el error 500 PrestaShop.

[WARNING] No confundas permisos con propietarios. A veces el problema no son los permisos, sino que los archivos pertenecen al usuario incorrecto (por ejemplo, root en lugar de www-data). Pero en este artículo nos centraremos en los permisos.

Paso 1: Identificar si el error es por permisos

Antes de lanzarte a cambiar permisos, asegúrate de que realmente sea la causa. Aquí tienes algunas pistas:

El error aparece al intentar acceder a cualquier página de la tienda (tanto frontend como backend).
En el panel de control de tu hosting (o en el archivo error.log de PrestaShop) ves mensajes como:
"Permission denied" o "Unable to write to file".
Has instalado recientemente un módulo o tema, o has modificado archivos manualmente.

Si no tienes acceso a los logs, puedes habilitar el modo debug de PrestaShop temporalmente (editando el archivo config/defines.inc.php y cambiando _PS_MODE_DEV_ a true). Esto te mostrará más detalles del error.

[INFO] Si no sabes cómo editar archivos PHP, puedes pedirle a tu soporte técnico que active el modo debug. O también puedes usar el administrador de archivos de tu panel de hosting (cPanel, Syspanel, etc.).

Paso 2: Acceder a tu servidor

Para cambiar permisos, necesitas acceso al servidor. Dependiendo de tu hosting, puedes hacerlo de dos formas:

Opción A: Usando un panel de control (recomendado para principiantes)

La mayoría de los paneles tienen un administrador de archivos. Por ejemplo, si usas Syspanel (antes conocido como HestiaCP), accedes por el puerto 2106 (ejemplo: https://tudominio.com:2106). Allí, en la sección de “Archivos”, puedes navegar hasta la carpeta de tu tienda y cambiar permisos desde el menú contextual.

Opción B: Usando SSH (para usuarios avanzados)

Si te sientes cómodo con la terminal, conecta por SSH a tu servidor y navega hasta la raíz de PrestaShop (normalmente /var/www/html o /home/usuario/web/tudominio/public_html).

Paso 3: Establecer los permisos correctos para PrestaShop

PrestaShop necesita permisos específicos para funcionar correctamente. Vamos a ver los más importantes.

Permisos para carpetas

Las carpetas deben tener 755 (rwxr-xr-x). Esto significa:

El propietario puede leer, escribir y ejecutar.
El grupo y otros solo pueden leer y ejecutar.

Permisos para archivos

Los archivos deben tener 644 (rw-r--r--). Esto significa:

El propietario puede leer y escribir.
El grupo y otros solo pueden leer.

Excepciones importantes

Carpeta config/: Debe tener permisos 755.
Carpeta cache/: Debe tener permisos 755.
Carpeta log/: Debe tener permisos 755.
Archivo config/settings.inc.php: Debe tener permisos 644 (o incluso 444 si no necesitas escribir en él).
Carpeta modules/: Permisos 755.
Carpeta themes/: Permisos 755.
Carpeta upload/: Permisos 755.
Carpeta download/: Permisos 755.
Carpeta img/: Permisos 755.
Carpeta mails/: Permisos 755.
Carpeta translations/: Permisos 755.

[TIP] No es necesario cambiar permisos uno por uno. Puedes usar comandos recursivos (como chmod -R) para aplicar a todo de una vez, pero ten cuidado: algunos archivos como index.php deben seguir siendo 644.

Paso 4: Cómo cambiar permisos de forma segura

Usando el administrador de archivos (Syspanel)

Accede a Syspanel en tu navegador: https://tudominio.com:2106.
Inicia sesión con tu usuario y contraseña.
Ve a “Archivos” y navega hasta la carpeta raíz de tu tienda.
Selecciona todas las carpetas y archivos (Ctrl+A).
Haz clic derecho y elige “Cambiar permisos”.
Introduce 755 para carpetas y 644 para archivos. Si el panel no distingue entre tipos, elige 755 para todo y luego cambia manualmente los archivos individuales (como index.php o settings.inc.php) a 644.
Guarda los cambios.

Usando SSH (línea de comandos)

Conéctate por SSH y ejecuta estos comandos (ajusta la ruta a tu instalación):

# Ir a la raíz de PrestaShop
cd /ruta/a/tu/tienda

# Cambiar permisos de carpetas a 755
find . -type d -exec chmod 755 {} \;

# Cambiar permisos de archivos a 644
find . -type f -exec chmod 644 {} \;

# Asegurar permisos específicos para archivos críticos
chmod 644 config/settings.inc.php
chmod 644 index.php
chmod 644 .htaccess

[WARNING] Si tu servidor usa PHP-FPM con un usuario diferente (por ejemplo, nobody o www-data), asegúrate de que el propietario de los archivos sea ese usuario. Si no, aunque los permisos sean correctos, el servidor no podrá leerlos. Para cambiar el propietario, usa chown -R usuario:grupo . (consulta con tu hosting cuál es el usuario adecuado).

Paso 5: Verificar y probar

Después de cambiar los permisos, es hora de comprobar si el error 500 ha desaparecido.

Limpia la caché de PrestaShop: Ve a tu panel de administración (si puedes acceder) y en “Parámetros de la tienda > Rendimiento” limpia la caché. Si no puedes acceder, borra manualmente la carpeta cache/smarty/cache/ y cache/smarty/compile/ (pero no borres los archivos index.php que hay dentro).
Prueba la tienda: Accede a tu dominio en el navegador. Si ves la página de inicio, ¡genial! Si no, prueba a recargar varias veces o usa el modo incógnito.
Revisa los logs: Si aún falla, mira el archivo var/logs/ (en PrestaShop 1.7) o log/ (en versiones anteriores) para ver mensajes de error más específicos.

Paso 6: Soluciones adicionales si el error persiste

Si después de ajustar permisos el error 500 sigue apareciendo, puede ser por otras causas:

Archivo .htaccess corrupto: Renómbralo a .htaccess.bak y genera uno nuevo desde el panel de administración (en “Parámetros de la tienda > SEO y URLs”).
Módulo conflictivo: Desactiva todos los módulos (renombra la carpeta modules a modules_old y crea una nueva vacía). Si el error desaparece, reactívalos uno por uno para encontrar el culpable.
PHP memory limit: Aumenta el límite de memoria en el archivo php.ini o en config/defines.inc.php (añade ini_set('memory_limit', '256M');).
Error en la base de datos: Revisa si la conexión a la base de datos es correcta en config/settings.inc.php.

[INFO] Si usas Syspanel, puedes revisar los logs del servidor desde la sección “Logs” del panel. Allí suelen aparecer errores de PHP que te darán pistas más concretas.

Preguntas frecuentes (FAQ)

¿Qué permisos debe tener la carpeta `config/` en PrestaShop?

Debe tener permisos 755 (rwxr-xr-x). El archivo settings.inc.php dentro de ella debe ser 644 (o 444 si no lo modificas).

¿Puedo usar permisos 777 para solucionar el error 500?

No es recomendable. Los permisos 777 dan acceso total a cualquier usuario, lo que supone un grave riesgo de seguridad. Solo úsalos de forma temporal y bajo tu responsabilidad, y luego cámbialos a 755/644.

¿Cómo cambio permisos desde cPanel?

En cPanel, usa el “Administrador de archivos”, selecciona los archivos/carpetas, haz clic en “Cambiar permisos” e introduce el número (755 para carpetas, 644 para archivos).

¿El error 500 puede deberse a la versión de PHP?

Sí, a veces PrestaShop no es compatible con versiones muy nuevas de PHP. Verifica que tu hosting use una versión compatible (por ejemplo, PHP 7.4 u 8.0 para PrestaShop 1.7).

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

Puedes cambiar permisos vía FTP o desde el administrador de archivos de tu panel de hosting (Syspanel, cPanel, etc.). Si no tienes ninguna de esas opciones, contacta a tu soporte técnico.

Conclusión

El error 500 en PrestaShop por permisos es molesto, pero por suerte tiene una solución clara y sencilla. Recuerda: carpetas a 755, archivos a 644, y presta especial atención a las carpetas de caché y configuración. Si sigues estos pasos, en la mayoría de los casos tu tienda volverá a la vida.

Si el problema persiste, no dudes en revisar los logs o pedir ayuda a tu proveedor de hosting. Y recuerda que en Syspanel (acceso por puerto 2106) tienes herramientas integradas para gestionar archivos y permisos de forma visual.

¡Espero que este artículo te haya sido de ayuda! Si tienes más dudas, déjalas en los comentarios (si los hay) o consulta la documentación oficial de PrestaShop.