SparkCMSDocs
Inicio/Docs/Instalación

Instalación

SparkCMS se instala como WordPress: subes los archivos a tu hosting, creas una base de datos y abres el wizard web. En 3 minutos tienes tu sitio funcionando. Esta guía cubre el método estándar (Hostinger/SiteGround/cPanel).

Requisitos mínimos: PHP 8.2+, MySQL 5.7+ (o MariaDB 10.3+), extensiones pdo_mysql, mbstring, openssl, json. 100 MB de disco. Disponibles por defecto en casi cualquier hosting compartido moderno.

Paso 1: Descargar SparkCMSPronto

La descarga pública del binario v0.1 estará disponible muy pronto. Mientras tanto, si quieres probarlo en un sitio real:

Paso 2: Crear la base de datos

Desde cPanel / hPanel de Hostinger:

  1. Entra a Bases de datos → MySQL Databases.
  2. Crea una nueva: nómbrala spark_mi_sitio.
  3. Crea un usuario dedicado y asígnalo a esa base con ALL PRIVILEGES.
  4. Apunta estos 4 valores — los pedirá el wizard:
    • Host (casi siempre localhost)
    • Nombre de la base (ej: u123_spark)
    • Usuario
    • Contraseña

Paso 3: Subir archivos por SFTP

Extrae el ZIP de SparkCMS y sube el contenido al directorio raíz de tu dominio (típicamente public_html/). Desde una terminal:

# Con lftp (recomendado — reintentos automáticos)
lftp -u "usuario,password" -p 22 sftp://tu-hosting.com -e "
  cd public_html
  mirror --reverse --parallel=5 ./sparkcms/ .
  bye
"

# O con rsync si tienes SSH
rsync -avz -e "ssh -p 65002" ./sparkcms/ usuario@tu-hosting.com:public_html/

Verifica que storage/ y public/uploads/ queden con permisos 755 para directorios y 644 para archivos. En Hostinger esto viene por defecto.

Paso 4: Ejecutar el wizard

Visita https://tudominio.com/install en el navegador. El wizard te guía en 4 pantallas:

  1. Chequeo: verifica PHP, MySQL, extensiones y permisos. Si algo falta, te dice qué corregir.
  2. Base de datos: pega las credenciales del paso 2. SparkCMS crea las tablas automáticamente.
  3. Admin: correo + contraseña del usuario administrador. Nombre del sitio.
  4. Template: eliges entre blog / agencia / landing / ecommerce / restaurante / portafolio.

Al terminar, aterrizas directamente en el admin. Tu sitio público ya está respondiendo en https://tudominio.com.

Paso 5: Primer contenido

Desde el admin (/admin) puedes:

Resolución de problemas frecuentes

"Error 500 al abrir /install"

Tu PHP probablemente está en versión < 8.2. Cámbialo desde el panel de hosting (en Hostinger: Avanzado → Configuración PHP → Versión PHP).

"No se puede conectar a la base de datos"

El host MySQL no siempre es localhost. Algunos hostings usan hostnames específicos (mysql.tudominio.com, mariadb.example). Busca el dato en la misma pantalla donde creaste la base.

"Los archivos subidos no se ven / 403"

El directorio public/uploads/ necesita permiso 755. En Hostinger por defecto viene así, pero si usaste un ZIP y lo descomprimiste en el servidor, Hostinger a veces deja los uploads como 644. Corrígelo con File Manager → botón derecho → Permisos.