Cómo hacer que PrestaShop funcione correctamente en Syspanel
Introducción: ¿Por qué PrestaShop necesita una configuración especial en Syspanel?
Si estás leyendo esto, probablemente acabas de contratar un hosting con Syspanel o estás migrando tu tienda online. Y te habrás dado cuenta de que PrestaShop no es un blog cualquiera: requiere PHP con ciertas extensiones, permisos de escritura en carpetas específicas y una base de datos MySQL bien configurada.
La buena noticia es que Syspanel (el panel de control que incluye HestiaCP, pero con un nombre propio y acceso por el puerto 2106) está preparado para soportar PrestaShop sin problemas. Solo hay que seguir unos pasos lógicos.
En este artículo te explico, paso a paso y sin tecnicismos innecesarios, cómo hacer que PrestaShop funcione correctamente en Syspanel. Desde la instalación inicial hasta los ajustes finos de rendimiento y seguridad.
¿Qué es Syspanel y por qué es ideal para PrestaShop?
Syspanel es el nombre que recibe el panel de control de tu hosting basado en HestiaCP. Accedes a él escribiendo en tu navegador:
https://tu-dominio.com:2106
Recuerda: el puerto de acceso es el 2106, no el 8083 ni el 2083. Es un detalle que confunde a muchos, pero una vez que lo tienes claro, todo es más fácil.
Syspanel te permite gestionar dominios, bases de datos, cuentas de correo, usuarios FTP y certificados SSL. Para PrestaShop, lo más importante es que puedes:
- Crear bases de datos MySQL con un clic.
- Configurar PHP con las extensiones que PrestaShop necesita.
- Gestionar archivos mediante el administrador de archivos o FTP.
- Activar SSL gratuito (Let's Encrypt) para tu tienda.
Requisitos previos antes de instalar PrestaShop
Antes de lanzarte a instalar, verifica que tu hosting con Syspanel cumple estos requisitos. Si no los cumple, tu tienda dará errores extraños como pantallas blancas o mensajes de "módulo no encontrado".
Requisitos de PHP
PrestaShop 8.x (la versión más actual) funciona mejor con PHP 7.4 o superior, aunque lo ideal es PHP 8.0 o 8.1. Syspanel te permite elegir la versión de PHP por dominio.
Extensiones PHP obligatorias
PrestaShop necesita estas extensiones activadas:
- curl
- gd
- intl
- mbstring
- openssl
- pdo_mysql
- zip
Si alguna falta, la instalación fallará o la tienda dará errores al activar módulos.
Base de datos
Necesitas crear una base de datos MySQL con un usuario y contraseña. PrestaShop soporta MySQL 5.7+ y MariaDB 10.x, que son las versiones que suele traer Syspanel por defecto.
Paso 1: Crear la base de datos en Syspanel
Este es el primer paso y es muy sencillo. Sigue estos pasos:
- Accede a Syspanel con tu usuario y contraseña en
https://tu-dominio.com:2106. - En el menú lateral, busca la sección "Bases de datos" o "MySQL".
- Haz clic en "Agregar base de datos".
- Rellena el formulario:
- Nombre de la base de datos: por ejemplo,
tienda_prestashop. - Usuario de la base de datos: por ejemplo,
tienda_user. - Contraseña: elige una segura y anótala, la necesitarás luego.
- Nombre de la base de datos: por ejemplo,
- Haz clic en "Guardar".
[TIP] Anota el nombre de la base de datos, el usuario y la contraseña en un archivo de texto. Los necesitarás durante la instalación de PrestaShop.
Paso 2: Configurar PHP para PrestaShop en Syspanel
Syspanel te permite elegir la versión de PHP para cada dominio. Esto es clave porque no todos los sitios en tu servidor necesitan la misma configuración.
- Ve a "Web" o "Dominios" en el menú principal.
- Localiza tu dominio (por ejemplo,
mutienda.com). - Haz clic en el botón de edición (normalmente un icono de lápiz o engranaje).
- Busca la opción "Versión de PHP" y selecciona PHP 8.1 (recomendado).
- Guarda los cambios.
Además, asegúrate de que las extensiones PHP estén habilitadas. En Syspanel, esto suele estar en la pestaña "PHP Extensions" o "Módulos PHP". Activa al menos las que mencioné antes.
[WARNING] Si tu PrestaShop es antiguo (versión 1.6 o 1.7), PHP 8.1 puede dar incompatibilidades con algunos módulos. En ese caso, usa PHP 7.4. Si tienes dudas, consulta con tu proveedor de hosting.
Paso 3: Subir los archivos de PrestaShop
Ahora tienes dos opciones: instalar PrestaShop desde el instalador web o subir los archivos manualmente. Te recomiendo la primera, es más rápida y evita errores de permisos.
Opción A: Instalación automática desde el instalador
- Descarga el paquete de PrestaShop desde prestashop-project.org (versión completa, no la de desarrollo).
- Descomprime el archivo ZIP en tu ordenador.
- Accede a Syspanel y ve a "Administrador de archivos" (o usa FTP).
- Navega hasta la carpeta
public_htmlde tu dominio. - Sube el archivo ZIP de PrestaShop y luego descomprímelo ahí mismo.
- Asegúrate de que los archivos estén en la raíz, no en una subcarpeta.
Opción B: Instalación manual con FTP
- Conecta con tu cliente FTP (FileZilla, por ejemplo) usando los datos que te da Syspanel.
- Sube todos los archivos de PrestaShop a la carpeta
public_html. - Esto puede tardar varios minutos si tienes muchos archivos.
[TIP] Si usas la opción manual, sube primero los archivos en un ZIP y descomprímelos en el servidor. Es mucho más rápido que subir miles de archivos uno a uno.
Paso 4: Ejecutar el instalador de PrestaShop
Una vez que los archivos están en el servidor, abre tu navegador y escribe:
https://tu-dominio.com
El instalador de PrestaShop debería aparecer automáticamente. Si no, ve a:
https://tu-dominio.com/install
Sigue estos pasos:
- Selecciona el idioma: elige español (o el que prefieras).
- Acepta la licencia: lee y acepta los términos.
- Verificación de compatibilidad: el instalador comprobará si tu servidor cumple los requisitos. Si algo falla, te lo dirá. Revisa las extensiones PHP.
- Información de la tienda: ponle nombre a tu tienda, selecciona tu actividad, etc.
- Conexión a la base de datos: aquí introduces los datos que creaste en el Paso 1:
- Servidor:
localhost(o127.0.0.1). - Nombre de la base de datos: el que pusiste.
- Usuario: el que creaste.
- Contraseña: la que elegiste.
- Prefijo de tablas: déjalo como
ps_por defecto.
- Servidor:
- Configuración de la cuenta de administrador: crea tu usuario y contraseña de acceso al panel de administración.
- Instalación: haz clic en "Instalar" y espera unos minutos.
[INFO] Si el instalador se queda en blanco o da error, revisa los permisos de las carpetas. En Syspanel, ve a "Administrador de archivos", selecciona la carpeta public_html y asegúrate de que los permisos sean 755 para carpetas y 644 para archivos.
Paso 5: Configurar PrestaShop después de la instalación
La instalación no termina cuando ves la pantalla de "¡Enhorabuena!". Hay que hacer ajustes importantes.
Activar el modo amigable de URLs
- Ve al panel de administración de PrestaShop (normalmente en
/admin). - En el menú lateral, busca "Configuración avanzada" → "SEO y URLs".
- Activa la opción "URLs amigables".
- Guarda los cambios.
[WARNING] Si esto no funciona, puede que necesites activar el módulo de reescritura de Apache en Syspanel. Ve a "Web" → tu dominio → "Apache" y asegúrate de que mod_rewrite esté habilitado.
Configurar la caché
- Ve a "Configuración avanzada" → "Rendimiento".
- Activa la "Caché de plantillas".
- Activa la "Caché de combinar, comprimir y cachear" (si tu hosting lo permite).
- Guarda.
Ajustar los permisos de carpetas
PrestaShop necesita escribir en ciertas carpetas. Si usas Syspanel, lo más fácil es:
- Ve a "Administrador de archivos".
- Selecciona las carpetas
cache,log,img,configyvar. - Cambia los permisos a
755(lectura, escritura y ejecución para el propietario, lectura y ejecución para el resto).
Paso 6: Activar SSL para tu tienda
Hoy en día, no tener SSL es un error grave. Google penaliza las tiendas sin HTTPS y los clientes desconfían.
- En Syspanel, ve a "Web" → tu dominio.
- Busca la sección "SSL" o "Certificados".
- Haz clic en "Let's Encrypt" y sigue las instrucciones.
- Acepta los términos y espera a que se genere el certificado (suele tardar menos de un minuto).
[TIP] Después de activar SSL, ve a PrestaShop y cambia la URL de la tienda a https://tu-dominio.com en "Configuración" → "Parámetros generales".
Configuración avanzada: optimizar PrestaShop en Syspanel
Una vez que tu tienda funciona, es hora de exprimir el rendimiento.
Usar PHP-FPM
Syspanel permite activar PHP-FPM por dominio. Esto mejora mucho la velocidad.
- Ve a "Web" → tu dominio.
- Busca la opción "PHP-FPM" y actívala.
- Guarda.
Configurar la memoria de PHP
PrestaShop necesita al menos 256 MB de memoria PHP. Si tu tienda tiene muchos módulos, sube a 512 MB.
- En Syspanel, ve a "Web" → tu dominio.
- Busca la opción "Configuración PHP".
- Cambia
memory_limita512M. - Guarda.
Activar la compresión Gzip
- Ve a "Web" → tu dominio → "Apache".
- Busca la opción de "Compresión" o añade este código al archivo
.htaccess:
<IfModule mod_deflate.c>
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript application/json
</IfModule>
Problemas comunes y soluciones en Syspanel
"Error de conexión a la base de datos"
- Verifica que el nombre de la base de datos, usuario y contraseña son correctos.
- Asegúrate de que el servidor de la base de datos es
localhost(o127.0.0.1). - Comprueba que la base de datos existe en Syspanel.
"La página se queda en blanco"
- Activa el modo de depuración en PrestaShop: ve a
config/defines.inc.phpy cambia_PS_MODE_DEV_atrue. - Revisa los logs de error en
var/logs/. - Aumenta
memory_limiten PHP.
"No puedo acceder al panel de administración"
- La URL suele ser
https://tu-dominio.com/admin(la carpeta que elegiste al instalar). - Si no funciona, revisa que el archivo
.htaccessno esté corrupto. - En Syspanel, regenéralo desde "Web" → tu dominio → "Apache".
Preguntas frecuentes (FAQ)
¿PrestaShop funciona en Syspanel?
Sí, perfectamente. Syspanel (basado en HestiaCP) incluye todo lo necesario: MySQL, PHP, Apache o Nginx, y SSL.
¿Puedo instalar PrestaShop 8 en Syspanel?
Sí, siempre que uses PHP 7.4 o superior. Te recomiendo PHP 8.1.
¿Cómo accedo a Syspanel?
Escribe https://tu-dominio.com:2106 en tu navegador. El puerto 2106 es el correcto.
¿Qué hago si la instalación se queda en "paso 3"?
Revisa las extensiones PHP. La más común que falta es intl. Actívala en Syspanel y reintenta.
¿Puedo tener varias tiendas PrestaShop en el mismo Syspanel?
Sí, creando subdominios o carpetas separadas. Eso sí, cada una necesita su propia base de datos.
Conclusión
Configurar PrestaShop en Syspanel no es complicado si sigues los pasos en orden. Lo más importante es:
- Crear la base de datos correctamente.
- Elegir la versión de PHP adecuada.
- Activar las extensiones necesarias.
- Subir los archivos y ejecutar el instalador.
- Ajustar permisos y activar SSL.
Con estos pasos, tu tienda funcionará rápido y estable. Y recuerda: para cualquier problema, el puerto de acceso a Syspanel es el 2106.
Si te ha quedado alguna duda, déjala en los comentarios y te ayudo a resolverla. ¡Buena suerte con tu tienda online!
