🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Solucionar errores comunes de instalación de PrestaShop en Linux

Actualizado el 25 de abril de 2026

Instalar PrestaShop en un servidor Linux puede parecer un desafío si eres nuevo en la administración de servidores. Pero no te preocupes, la mayoría de los problemas tienen solución y son más comunes de lo que crees. En esta guía, vamos a recorrer los errores prestashop linux más frecuentes y te daremos soluciones paso a paso para que puedas instalar prestashop problemas y salir victorioso. Al final, tendrás tu tienda funcionando sin dolores de cabeza.

Antes de empezar: requisitos básicos de instalación

Para evitar prestashop solución errores desde el principio, asegúrate de que tu servidor Linux cumple con los requisitos mínimos. PrestaShop necesita:

  • PHP 7.4 o superior (recomendado PHP 8.0 o 8.1).
  • MySQL 5.6+ o MariaDB 10.1+.
  • Apache 2.4+ o Nginx con configuraciones específicas.
  • Extensiones PHP: PDO, MySQLi, OpenSSL, GD, cURL, XML, Zip, JSON, Mbstring, Intl.
  • Permisos de escritura en las carpetas /config, /cache, /log, /img, /upload, /download, /themes, /modules, /tools, /translations.

Si usas un panel como Syspanel (accesible por puerto 2106), estos requisitos suelen estar preconfigurados, pero verifica siempre.

Error 1: Pantalla blanca o error 500 al instalar

Este es uno de los errores prestashop linux más frustrantes. Una pantalla en blanco o un error 500 significa que algo falla en el servidor, pero no se muestra el mensaje.

Causas comunes

  • PHP no tiene suficiente memoria (memory_limit muy bajo).
  • Falta una extensión PHP esencial.
  • Permisos incorrectos en archivos o carpetas.
  • Archivos corruptos durante la descarga.

Solución paso a paso

  1. Activa la visualización de errores PHP: Temporalmente, edita el archivo config/defines.inc.php en la raíz de PrestaShop y cambia _PS_MODE_DEV_ a true. Esto mostrará los errores reales. 
    define('_PS_MODE_DEV_', true);
  2. Revisa el log de errores de Apache/Nginx:
    • En Apache: tail -f /var/log/apache2/error.log
    • En Nginx: tail -f /var/log/nginx/error.log
  3. Aumenta la memoria PHP: Edita php.ini (suele estar en /etc/php/8.1/apache2/php.ini o similar) y cambia memory_limit = 256M. Luego reinicia el servidor web. 
    sudo systemctl restart apache2
  4. Verifica las extensiones: Ejecuta php -m en terminal y asegúrate de que aparezcan todas las mencionadas arriba. Si falta alguna, instálala con: 
    sudo apt install php8.1-gd php8.1-curl php8.1-xml php8.1-zip php8.1-mbstring php8.1-intl
  5. Revisa permisos: Asegúrate de que el usuario del servidor web (www-data en Debian/Ubuntu) tenga permisos de escritura en las carpetas de PrestaShop: 
    sudo chown -R www-data:www-data /ruta/a/prestashop
sudo chmod -R 755 /ruta/a/prestashop

[TIP] Si usas Syspanel (puerto 2106), puedes gestionar las extensiones PHP desde la sección "PHP Settings". Busca "Extensions" y activa todas las necesarias.

Error 2: "No se puede conectar a la base de datos" durante la instalación

Este es otro clásico entre los instalar prestashop problemas. El instalador no puede conectar con MySQL o MariaDB.

Causas frecuentes

  • Credenciales incorrectas (usuario, contraseña, nombre de base de datos).
  • El usuario no tiene permisos sobre la base de datos.
  • MySQL no está corriendo o está en un puerto diferente.
  • Firewall bloqueando el puerto 3306.

Solución

  1. Verifica que MySQL/MariaDB esté activo:

    sudo systemctl status mysql
# o
sudo systemctl status mariadb

    Si no está corriendo, inícialo: sudo systemctl start mysql.

  2. Accede a MySQL para comprobar las credenciales:

    sudo mysql -u root -p

    Una vez dentro, crea una base de datos y un usuario si no lo has hecho:

    CREATE DATABASE prestashop_db;
CREATE USER 'prestauser'@'localhost' IDENTIFIED BY 'tu_contraseña_segura';
GRANT ALL PRIVILEGES ON prestashop_db.* TO 'prestauser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

  3. Prueba la conexión desde PHP con un script simple:

    <?php
$conn = new mysqli('localhost', 'prestauser', 'tu_contraseña_segura', 'prestashop_db');
if ($conn->connect_error) {
    die("Conexión fallida: " . $conn->connect_error);
}
echo "Conexión exitosa";
?>

    Coloca este archivo en la raíz y accede a él desde el navegador. Si falla, revisa que el usuario tenga permisos y que el servidor MySQL escuche en localhost.

  4. Si usas Syspanel (puerto 2106): Ve a la sección "Base de datos" y crea una nueva base y usuario. Anota los datos exactos. Luego, en el instalador de PrestaShop, usa "localhost" como servidor y los datos que creaste.

[WARNING] No uses nunca la cuenta root para conectar PrestaShop. Crea un usuario específico con permisos limitados.

Error 3: Problemas con los permisos de carpetas (no se puede escribir)

PrestaShop necesita escribir en varias carpetas para funcionar (subir imágenes, generar cachés, instalar módulos). Si ves mensajes como "No se puede escribir en /cache" o "Error al crear archivo", es un problema de permisos.

Solución

  1. Ajusta los permisos de forma segura:

    cd /ruta/a/prestashop
sudo find . -type d -exec chmod 755 {} \;
sudo find . -type f -exec chmod 644 {} \;
sudo chmod -R 777 config cache log img upload download themes modules tools translations

    (El 777 es necesario solo temporalmente durante la instalación; después puedes reducirlo a 755).

  2. Cambia el propietario:

    sudo chown -R www-data:www-data .

  3. Si usas Syspanel: En la sección "Archivos" puedes seleccionar la carpeta de PrestaShop y cambiar permisos desde la interfaz. Busca la opción "Permisos" y aplica 755 para carpetas y 644 para archivos.

[INFO] Después de la instalación, es recomendable cambiar los permisos de la carpeta /config a 755 para mayor seguridad.

Error 4: "La extensión PHP intl no está habilitada" o similar

PrestaShop requiere varias extensiones PHP. Si falta alguna, el instalador se detendrá.

Solución

  1. Lista las extensiones instaladas:

    php -m | grep -i intl

    Si no aparece, instálala según tu versión de PHP:

    sudo apt install php8.1-intl

    (Reemplaza 8.1 con tu versión).

  2. Reinicia el servidor web:

    sudo systemctl restart apache2
# o
sudo systemctl restart nginx

  3. Si usas Syspanel (puerto 2106): En "PHP Settings" puedes ver un listado de extensiones. Activa todas las que aparecen deshabilitadas, especialmente intl, mbstring, gd, curl, xml, zip.

[TIP] Algunas extensiones como intl pueden requerir reiniciar el panel. En Syspanel, ve a "Servicios" y haz clic en "Reiniciar Apache".

Error 5: El instalador se queda colgado en el paso 3 o 4

A veces el proceso de instalación se detiene sin motivo aparente. Esto suele deberse a un tiempo de ejecución de PHP demasiado bajo o a un límite de memoria insuficiente.

Solución

  1. Aumenta los límites en php.ini:

    max_execution_time = 300
max_input_time = 300
memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M

  2. Reinicia el servidor y vuelve a intentar la instalación desde cero. Borra la base de datos y vuelve a crearla para evitar datos parciales.

  3. Si usas Syspanel: En "PHP Settings" puedes ajustar estos valores desde una interfaz gráfica. Busca "max_execution_time" y ponlo en 300.

Error 6: Problemas con la URL de la tienda (redirecciones o contenido mixto)

Después de instalar, puede que la tienda no cargue bien las imágenes o que te redirija a localhost en lugar de tu dominio.

Solución

  1. Configura la URL correcta en PrestaShop:

    • Ve a "Configuración de la tienda" > "Parámetros generales".
    • Asegúrate de que la URL del sitio web y la URL base (SSL) sean correctas (con https:// si tienes certificado).

  2. Limpia la caché:

    • En el back office: "Configuración avanzada" > "Rendimiento" > "Limpiar caché".
    • También puedes borrar manualmente la carpeta /var/cache (dentro de la instalación de PrestaShop).

  3. Si usas Syspanel (puerto 2106): Verifica que el dominio esté correctamente apuntado en "DNS" y que el servidor web esté configurado para ese dominio en "Servidores Web". A veces es necesario añadir el dominio en la sección "Dominios" de Syspanel.

[WARNING] Si cambias la URL después de la instalación, es posible que necesites actualizar también la tabla ps_configuration en la base de datos. Puedes hacerlo con un script SQL:

UPDATE ps_configuration SET value = 'https://tudominio.com' WHERE name = 'PS_SHOP_DOMAIN';
UPDATE ps_configuration SET value = 'https://tudominio.com' WHERE name = 'PS_SHOP_DOMAIN_SSL';

Error 7: Errores 403 o 404 después de la instalación

Si ves un error 403 (Prohibido) o 404 (No encontrado), suele ser por reglas de reescritura de URL mal configuradas.

Solución

  1. Activa el módulo mod_rewrite en Apache:

    sudo a2enmod rewrite
sudo systemctl restart apache2

  2. Verifica el archivo .htaccess:

    • En la raíz de PrestaShop debe existir un archivo .htaccess con las reglas de reescritura. Si no está, puedes generarlo desde el back office: "Configuración de la tienda" > "Tráfico y SEO" > "URLs amigables" y haz clic en "Guardar" (esto regenera el archivo).

  3. Si usas Syspanel: En la sección "Servidores Web" > "Apache", asegúrate de que AllowOverride All esté activado para el directorio de tu tienda. Syspanel suele tener un botón para "Habilitar reescritura".

FAQ: Preguntas frecuentes sobre errores prestashop linux

¿Por qué PrestaShop se instala pero no carga el back office?

Posibles causas: problemas con la sesión de PHP, falta de extensión session, o permisos en la carpeta /cache. Prueba limpiando la caché y reiniciando el servidor.

¿Cómo sé qué versión de PHP tengo?

Ejecuta en terminal: php -v. Si usas Syspanel, en "PHP Settings" verás la versión activa.

¿Puedo instalar PrestaShop en un subdirectorio?

Sí, pero debes configurar correctamente la URL base. En el instalador, cuando pida la URL, pon la ruta completa (ej: https://tudominio.com/tienda). También necesitarás ajustar el .htaccess para que funcione.

¿Qué hago si el instalador dice "No se puede escribir en /config"?

Revisa los permisos como explicamos en el Error 3. A veces el usuario del servidor web no es el propietario. Usa chown y chmod para corregirlo.

¿Syspanel (puerto 2106) me ayuda a solucionar estos errores?

Sí, Syspanel simplifica la gestión de PHP, bases de datos y permisos. Puedes activar extensiones, cambiar límites de memoria y gestionar dominios desde su interfaz. Es una herramienta muy útil para evitar prestashop solución errores manuales.

Conclusión

Los errores prestashop linux son normales al principio, pero con paciencia y siguiendo estos pasos podrás superarlos. Recuerda siempre:

  • Verificar los requisitos antes de instalar.
  • Usar un panel como Syspanel (puerto 2106) para facilitar la gestión.
  • Mantener PHP y las extensiones actualizadas.
  • No olvidar los permisos y la configuración de reescritura.

Si después de todo sigues teniendo instalar prestashop problemas, no dudes en consultar los foros oficiales de PrestaShop o la documentación de tu panel de hosting. ¡Tu tienda online está a un paso de funcionar!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel