---
title: "Guía de instalación"
description: "Instalar Éclair CMS en 3 minutos: requisitos, descarga, subida por FTP o con el gestor de archivos, asistente de 4 pasos y primeros ajustes."
url: "https://eclaircms.org/es/instalacion"
lang: "es"
author: "Thierry Gustin"
published: "2026-10-30"
updated: "2026-10-31"
---

# Guía de instalación

> **Lo esencial** — Para instalar Éclair CMS necesitas un hosting con PHP 8.1 o superior (se recomienda 8.3), Apache o LiteSpeed y un certificado HTTPS. Descarga el archivo de 440 KB, sube el contenido de la carpeta eclair a la carpeta pública de tu sitio (archivos .htaccess incluidos), abre la dirección de tu sitio y responde a las 4 preguntas del asistente, en las 2 horas siguientes a tu primera visita.

Instalar Éclair CMS lleva unos 3 minutos: no hay que crear ninguna base de datos ni rellenar ningún archivo de configuración. Subes una carpeta a tu hosting, abres la dirección de tu sitio y un asistente te hace cuatro preguntas. Esta guía detalla cada paso con capturas de pantalla y repasa los ajustes que conviene hacer justo después.

> **¿Tienes tu hosting en o2switch?** — Mejor sigue [la guía específica para o2switch](https://eclaircms.org/es/instalacion/o2switch): muestra cada menú de cPanel, del dominio al certificado HTTPS. Para probar Éclair sin hosting, consulta [la instalación en tu ordenador](https://eclaircms.org/es/instalacion/local).

## ¿Qué necesitas para instalar Éclair CMS?

Un hosting web corriente, como un plan compartido de unos pocos euros al mes. No hace falta ninguna base de datos.

| Elemento | Mínimo | Recomendado |
| --- | --- | --- |
| Versión de PHP | 8.1 | 8.3 u 8.4 |
| Extensiones de PHP imprescindibles | `mbstring`, `json`, `dom`, `session` | presentes por defecto casi en todas partes |
| Extensiones de PHP aconsejables | — | `gd` (imágenes WebP), `zip` (copias de seguridad), `curl` (IndexNow, asistente IA), `zlib` (administración traducida) |
| Servidor web | Apache o LiteSpeed con `.htaccess` | igual, o Nginx con la [configuración incluida](https://eclaircms.org/es/documentacion/desarrolladores) |
| Certificado HTTPS | recomendado | Let’s Encrypt, gratuito en casi todos los proveedores |
| Espacio en disco | 1 MB para Éclair | más tus imágenes |
| Base de datos | ninguna | ninguna |

Casi cualquier hosting compartido sirve: o2switch, OVH, Hostinger, IONOS, PlanetHoster… Y no te preocupes: el asistente de instalación lo comprueba todo por ti y te explica qué corregir.

## Paso 1: descargar Éclair

Descarga el archivo oficial y descomprímelo en tu ordenador (doble clic en Mac; en Windows, clic derecho › Extraer todo).

[Descargar Éclair 1.7.0 (440 KB)](https://github.com/Jacckisback/eclair-cms/raw/main/dist/eclair-cms-1.7.0.zip)

Obtienes una carpeta `eclair` y tres archivos de texto (léame, licencia MIT y avisos de terceros) que no hace falta subir. Esto es lo que contiene la carpeta `eclair`:

| Elemento | Función |
| --- | --- |
| `index.php` | El punto de entrada: sirve las páginas en caché sin cargar la aplicación |
| `.htaccess` | URL limpias, protecciones, compresión y caché del navegador (archivo oculto) |
| `app/` | El código de Éclair, la administración y el tema |
| `assets/` | El CSS y el JavaScript de la administración, y el pequeño script del sitio |
| `data/` | Tus contenidos, ajustes y cuentas, creados al instalar y nunca públicos |
| `cache/` | Las páginas ya generadas |
| `media/` | Tus imágenes |
| `eclair-config.exemple.php` | Una plantilla de ajustes avanzados, opcional |

## Paso 2: subir los archivos a tu hosting

El objetivo: que `index.php`, `.htaccess` y las carpetas `app`, `assets`, `data`, `cache` y `media` queden **directamente en la carpeta pública de tu sitio**. Según el proveedor, se llama `public_html`, `www` o `htdocs`, o lleva el nombre de tu dominio.

### Con el gestor de archivos de tu proveedor

Es el método más sencillo y no hay que instalar ningún programa:

1. Abre el gestor de archivos desde el área de cliente de tu proveedor (en cPanel: **Archivos › Administrador de archivos**).
2. Ve a la carpeta pública de tu sitio y sube el archivo `eclair-cms-1.7.0.zip`.
3. Haz clic derecho sobre el archivo y elige **Extraer**: aparece una carpeta `eclair`.
4. Muestra los archivos ocultos (en cPanel: **Configuración › Mostrar archivos ocultos (dotfiles)**), abre la carpeta `eclair`, selecciona **todo** su contenido, `.htaccess` incluido, y muévelo un nivel hacia arriba, a la carpeta pública.
5. Borra la carpeta `eclair`, ya vacía, y el archivo ZIP.

### Con un programa FTP como FileZilla

1. Consigue los datos de acceso FTP en el área de cliente de tu proveedor: servidor, usuario, contraseña (y puerto 22 si ofrece SFTP, más seguro).
2. Conéctate con [FileZilla](https://filezilla-project.org/), que es gratuito, y abre la carpeta pública de tu sitio en la columna de la derecha.
3. Activa **Servidor › Forzar mostrar archivos ocultos**; si no, el `.htaccess` puede quedarse sin subir.
4. En la columna de la izquierda, abre la carpeta `eclair`, selecciona todo su contenido y arrástralo a la derecha.

> **No olvides el archivo .htaccess** — Su nombre empieza por un punto, así que está oculto por defecto. Sin él, todas las páginas salvo la de inicio muestran un error 404. El asistente te avisa si falta.

### ¿Y en una subcarpeta o en un subdominio?

También funciona. Para un sitio en la dirección `ejemplo.es/sitio/`, basta con subir los archivos a la carpeta `sitio`: Éclair detecta la subcarpeta por sí solo. Para un subdominio como `blog.ejemplo.es`, súbelos a la carpeta asociada a ese subdominio.

## Paso 3: responder a las 4 preguntas del asistente

Para instalar Éclair CMS solo queda abrir la dirección de tu sitio en el navegador: arranca el asistente de instalación, en español o en cualquiera de los otros 6 idiomas que se ofrecen arriba a la derecha.

> **Una ventana de 2 horas** — Por seguridad, la instalación debe terminarse en las 2 horas siguientes a la primera visita: si no, cualquiera podría apropiarse de un sitio subido y olvidado. Pasado ese plazo, borra el archivo `data/install-window.php` por FTP y recarga la página.

### Bienvenida: la comprobación de tu hosting

El asistente comprueba la versión de PHP, las extensiones, los permisos de escritura de las carpetas, el HTTPS y la reescritura de URL. Si todo está en verde, haz clic en **Vamos allá**. Si un punto está en rojo, el asistente te explica qué corregir con tu proveedor.

![Asistente de instalación de Éclair, pantalla de bienvenida: 14 puntos comprobados, el hosting está listo](https://eclaircms.org/media/2026/10/es-installer-welcome.webp)
*«14 puntos comprobados: tu hosting está listo».*

### Pregunta 1: tu sitio

Indica el **Nombre del sitio**, un **Eslogan** opcional y el **Idioma del sitio**, y elige después el tipo de sitio. Todo se puede cambiar más tarde.

![Asistente de instalación de Éclair, paso Tu sitio: nombre, eslogan, idioma y tipo de sitio](https://eclaircms.org/media/2026/10/es-installer-site.webp)

El tipo que elijas determina las primeras páginas que se crean para ti:

| Tipo | Lo que crea Éclair |
| --- | --- |
| 🏢 Web corporativa | Inicio (portada, ventajas, últimos artículos), Servicios con FAQ, Sobre nosotros, Contacto, Blog y páginas legales |
| ✍️ Blog | Inicio con los últimos artículos, Sobre nosotros, Contacto, una categoría «Guías» y páginas legales |
| 🧑‍💻 Freelance / portfolio | Inicio con tu nombre, habilidades, Sobre nosotros, Blog, Contacto y páginas legales |
| 🎯 Página única | Una página de venta (portada, ventajas, FAQ, formulario) y las páginas legales, sin blog |

### Pregunta 2: tu cuenta

Tu nombre, tu correo electrónico y una contraseña de al menos 10 caracteres. Se rechazan las contraseñas demasiado comunes y un indicador te muestra lo segura que es la tuya.

![Asistente de instalación de Éclair, paso Tu cuenta: nombre, correo electrónico y contraseña con indicador de seguridad](https://eclaircms.org/media/2026/10/es-installer-account.webp)

> **Una contraseña segura y fácil de recordar** — Una frase de cuatro palabras, como `Luz-sobre-la-colina-2026`, es mucho más robusta que una palabra corta llena de símbolos. Guárdala en tu gestor de contraseñas.

### Pregunta 3: tu visibilidad

- **Google y Bing pueden indexar mi sitio**: desmárcalo si prefieres construir tu sitio con calma antes de mostrarlo.
- **Las inteligencias artificiales (ChatGPT, Perplexity, Gemini…)**: *Bienvenidas* (pueden leer y citar tu sitio; es la opción recomendada), *Solo citas* (te citan sin entrenar sus modelos con tus textos) o *No, gracias*.
- **Dirección de tu administración**: sustituye `admin` por una palabra tuya, o haz clic en **Generar una dirección secreta**. Una dirección propia aleja a los bots maliciosos.

![Asistente de instalación de Éclair, paso Visibilidad: indexación en Google y Bing, bots de IA y dirección de la administración](https://eclaircms.org/media/2026/10/es-installer-visibility.webp)

### Pregunta 4: el resumen

Repasa tus elecciones y haz clic en **Crear mi sitio ⚡**. Éclair crea tus páginas, un artículo de ejemplo, tu cuenta, el sitemap y los iconos del sitio.

![Asistente de instalación de Éclair, resumen de tus elecciones antes de crear el sitio](https://eclaircms.org/media/2026/10/es-installer-summary.webp)

### ¡Tu sitio ya está en línea!

Confeti, y tu sitio queda publicado. **Anota bien la dirección de tu administración** (por ejemplo `https://tu-sitio.es/estudio`) y guárdala en marcadores: a partir de ahora, ahí es donde iniciarás sesión.

![Final de la instalación de Éclair: tu sitio ya está en línea, con la dirección de la administración para guardar en marcadores](https://eclaircms.org/media/2026/10/es-installer-done.webp)

## Paso 4: tus primeros ajustes en 10 minutos

El panel te recibe con una lista de **Primeros pasos**: cada línea te lleva a la pantalla adecuada.

![Panel de Éclair justo después de la instalación, con la lista de Primeros pasos](https://eclaircms.org/media/2026/10/es-dashboard-getting-started.webp)

1. **Añade tu logo y tu color** (Ajustes › Apariencia): el contraste de los colores se mantiene legible automáticamente.
2. **Personaliza la página de inicio**: sustituye los textos de ejemplo por tu propia oferta.
3. **Escribe tu primer artículo**, apoyándote en las notas SEO y GEO del editor.
4. **Completa tu perfil de autor**: foto, cargo y biografía refuerzan la confianza de Google y de las IA.
5. **Activa la verificación en dos pasos** (Mi perfil › Verificación en dos pasos).
6. **Completa el aviso legal**, obligatorio tanto en Francia como en España.
7. **Conecta tu sitio a Google Search Console** (Ajustes › SEO): pega la etiqueta de verificación y Éclair extrae el código.

Añade un octavo paso: en **Seguridad**, haz clic en **Verificar la dirección del sitio**. Una vez confirmada la dirección, Éclair redirige a los visitantes a la dirección oficial (con o sin www) e impone el HTTPS.

![Página Seguridad de la administración de Éclair: nivel de protección, prueba de protección de carpetas e integridad de los archivos](https://eclaircms.org/media/2026/10/es-security-page.webp)
*La página Seguridad: nivel de protección, prueba de las carpetas protegidas y control de integridad de los archivos.*

El detalle de cada ajuste está en [Primeros pasos tras la instalación](https://eclaircms.org/es/documentacion/primeros-pasos).

## ¿Qué hacer si la instalación no arranca?

| Lo que ves | Solución |
| --- | --- |
| «Éclair a besoin de PHP 8.1 ou plus récent» (en francés: «Éclair necesita PHP 8.1 o superior») | Cambia la versión de PHP en el área de cliente de tu proveedor y recarga la página |
| Error 404 en todas las páginas salvo la de inicio | No se subió el `.htaccess`: muestra los archivos ocultos y vuelve a subirlo |
| Error 500 justo después de la subida | Tu proveedor rechaza una directiva del `.htaccess`: ponte en contacto con él ([detalles](https://eclaircms.org/es/documentacion/solucion-de-problemas#error-500)) |
| «Instalación bloqueada» | Ha pasado la ventana de 2 horas: borra `data/install-window.php` y recarga la página |
| Una carpeta «sin permisos de escritura» | Da permisos 755 a las carpetas `data`, `cache` y `media` con tu programa FTP |

Para todo lo demás, consulta [la guía de solución de problemas](https://eclaircms.org/es/documentacion/solucion-de-problemas) o [escríbeme](https://eclaircms.org/es/contacto).

## Preguntas sobre la instalación

### ¿Cuánto tiempo se tarda en instalar Éclair?

Unos 3 minutos: lo que cuesta subir menos de 1 MB de archivos y responder a las 4 preguntas del asistente. Cuenta con unos minutos más si antes tienes que activar el certificado HTTPS o cambiar la versión de PHP.

### ¿Hace falta crear una base de datos para instalar Éclair CMS?

No. Éclair no usa ninguna base de datos: tus contenidos son archivos protegidos de la carpeta `data`. No tienes que crear ninguna base ni introducir credenciales de MySQL.

### ¿Puedo instalar Éclair en un hosting que ya tiene un sitio?

Sí, en una subcarpeta (por ejemplo `ejemplo.es/nuevo/`) o en un subdominio. Éclair detecta automáticamente la carpeta en la que está instalado.

### ¿Puedo probar Éclair antes de ponerlo en línea?

Sí: instálalo en tu ordenador con un servidor local, siguiendo [la instalación en tu ordenador](https://eclaircms.org/es/instalacion/local). Después podrás mover toda la carpeta a tu proveedor de hosting.

### ¿Cómo desinstalo Éclair?

Borra sus archivos y sus carpetas: como no hay base de datos, no queda nada más en tu hosting. Antes, descarga una copia de seguridad desde la página Seguridad si quieres conservar tus contenidos.

[Instalar Éclair en o2switch, paso a paso](https://eclaircms.org/es/instalacion/o2switch)