Migrar de October CMS a Astro: guía para agencias

Te llega un cliente nuevo. Tiene una web que va bien, pero el desarrollador original desapareció hace tres años y la dejó montada en October CMS. Nadie en tu equipo lo ha tocado nunca. El cliente quiere cambios y la pregunta cae sobre la mesa: ¿seguimos con esto o lo movemos a algo que controlemos?

Es una situación más común de lo que parece. October CMS tuvo su momento y todavía mueve muchas webs corporativas. Por eso, antes de prometer nada, conviene entender cuándo migrar de October CMS a Astro es la jugada correcta y cuándo no. No siempre lo es. Pero cuando lo es, resuelve de golpe el rendimiento, el mantenimiento y la dependencia de un stack que tu agencia no domina.

¿Qué es October CMS y por qué te lo vas a encontrar?

October CMS es un gestor de contenidos construido sobre Laravel, el framework PHP. Apareció como alternativa “para desarrolladores” frente a WordPress: más limpio, más estructurado, sin el caos de plugins. Durante años fue una opción sólida para webs corporativas a medida, y muchas agencias y freelances lo usaron para proyectos serios. Yo mismo monté la web corporativa de Maxus sobre October CMS —puedes ver ese caso aquí—, así que hablo de algo que he tenido en producción, no de oídas.

El problema no es October en sí. Es lo que pasa después. Es un CMS de nicho: hay muchos menos desarrolladores que lo conocen que para WordPress, el ecosistema se mueve despacio y la curva para retomar un proyecto ajeno es empinada. Cuando una agencia hereda un sitio así, suele encontrarse con un theme a medida que nadie documentó, plugins de pago caducados y un hosting PHP que toca mantener. Funciona. Pero cada cambio cuesta más de lo que debería.

Mantener o migrar: cuándo tiene sentido cada opción

Antes de vender una migración, sé honesto con el cliente y contigo. Migrar cuesta tiempo y dinero. Si no resuelve un dolor real, no lo hagas.

Mantén el October CMS si: el sitio cumple, se actualiza poco, el rendimiento es decente y el cliente no pide autonomía para publicar. Una web que funciona y a la que se le tocan dos cosas al año no justifica una migración. Ahí tu trabajo es encontrar a alguien que sepa de October —o aprender lo justo— y hacer los retoques.

Migra a Astro si se cumplen varios de estos:

• El theme es un infierno de tocar y cada cambio se eterniza.
• Los Core Web Vitals están en rojo y arrastran el SEO del cliente.
• El hosting PHP da sustos: caídas, versiones desactualizadas, parches de seguridad pendientes.
• El cliente quiere publicar contenido sin depender de una instalación frágil.
• Vas a rehacer el diseño igualmente, así que el coste de migrar el contenido se diluye en el rediseño.

La señal más clara es esta última. Si vas a rediseñar, migrar el stack a la vez casi siempre compensa: no tiene sentido invertir horas en maquetar un diseño nuevo sobre una base que querías abandonar.

Por qué Astro es buen destino para una web de October CMS

October genera HTML en el servidor con PHP en cada visita. Astro hace lo contrario: construye el sitio una vez y sirve HTML estático, sin servidor que ejecute nada en cada carga. Para una web corporativa —que es contenido, no una aplicación— ese cambio se nota.

Lo que ganas trasladándolo a Astro:

• Rendimiento de serie. Sin PHP en tiempo de ejecución, sin base de datos en cada visita. El sitio se sirve estático desde CDN y los Core Web Vitals suben casi sin pelear. Es el tipo de mejora que reportas al cliente con un antes y un después en PageSpeed.
• Cero mantenimiento de servidor. No hay PHP que parchear ni versión de Laravel que vigilar. Despliegas archivos estáticos en cualquier hosting barato y se acabaron los sustos de seguridad del backend.
• Contenido manejable. Astro gestiona blog y páginas con colecciones en Markdown versionadas en Git, o conectando un CMS headless por API si el cliente necesita un panel visual. Tú eliges según quién publique.
• Stack que tu agencia controla. HTML, CSS y JavaScript moderno. Cualquier dev del equipo entra sin aprender un framework PHP de nicho. Esa es, muchas veces, la razón de peso real.

Si en tu agencia ya trabajáis con stacks modernos, esto encaja con lo que hacéis. Y si necesitáis manos para la parte técnica, es justo el tipo de proyecto en el que entro como socio técnico white-label.

Cómo migrar de October CMS a Astro, paso a paso

La migración no es magia. Es un proyecto acotado y ordenado. Estos son los pasos que sigo.

1. Auditar el contenido y las rutas reales

Antes de tocar código, saca el inventario. Qué páginas existen de verdad, qué URLs tienen, cuáles reciben tráfico y cuáles son zombis que nadie visita. Cruza la lista de rutas de October con Search Console y Analytics. Aquí decides qué se migra, qué se fusiona y qué se tira. Migrar páginas muertas es trabajo pagado a cambio de nada.

2. Exportar el contenido

October guarda el contenido en la base de datos y en archivos del theme. Extrae los textos, las imágenes y los metadatos a un formato neutro —Markdown o JSON— que Astro pueda consumir. Si el sitio es pequeño, a mano. Si tiene cientos de entradas, con un script que lea la base de datos y vuelque cada registro. Este paso es el menos vistoso y el que más tiempo come.

3. Reconstruir las plantillas en Astro

Las plantillas Twig de October se rehacen como componentes .astro. No es portar línea a línea: es aprovechar para limpiar el marcado, quitar lo que sobra y dejar una base mantenible. El contenido entra por colecciones; el diseño, por componentes reutilizables. Aquí es donde la web deja de ser una caja negra y pasa a algo que tu equipo edita sin miedo.

4. Montar los redirects 301 (el paso que no puedes saltarte)

Este es el que hunde migraciones cuando se ignora. Las URLs nuevas no coincidirán con las viejas. Si dejas las antiguas devolviendo 404, tiras por la borda el SEO que el cliente lleva años acumulando. Monta un mapa de redirecciones 301 de cada URL antigua a su equivalente nueva, una a una. Sin esto, la migración técnica puede ser perfecta y el cliente perder posiciones igualmente.

5. Revisar el SEO técnico antes de publicar

Con el sitio montado, repasa lo que se rompe en toda migración: metatítulos y descripciones, datos estructurados (Schema.org), sitemap.xml, robots.txt, etiquetas canónicas y los hreflang si la web es multiidioma. Es exactamente el trabajo de una auditoría de SEO técnico, y conviene hacerlo antes de apuntar el dominio, no después de que el cliente vea caer el tráfico.

Qué no subestimar en la migración

Tres cosas que parecen menores y luego dan guerra:

• Los formularios. En October los gestiona el backend PHP. Astro es estático, así que necesitas un servicio externo o un endpoint serverless para recibir los envíos. Pásalo a producción y pruébalo de verdad antes de quitar el sitio viejo.
• Las imágenes y los alt. Migra los alt reales, no marcadores. Es accesibilidad y es SEO de imágenes, y se pierde con facilidad en la exportación.
• El periodo de solape. No apagues October hasta que Astro esté en producción, los redirects respondan y Search Console no escupa errores. Un par de semanas de convivencia ahorran un disgusto.

En resumen

Migrar de October CMS a Astro no es un capricho técnico: es quitarte de encima un stack de nicho, subir el rendimiento del cliente y recuperar el control de un proyecto que tu agencia pueda mantener. Pero solo cuando hay un dolor real detrás. Si el sitio cumple y nadie sufre, mantenerlo es la opción barata y sensata.

¿Has heredado un cliente con una web en October CMS y no sabes si mantenerla o migrarla? Cuéntame el caso y te digo con franqueza qué haría yo —migrar, mantener o un punto intermedio— y qué supondría en horas.

Preguntas frecuentes

¿Se puede migrar de October CMS a Astro sin perder el SEO?

Sí, si planificas los redirects. October CMS y Astro generan URLs distintas, así que el riesgo no es la tecnología: es dejar rutas viejas devolviendo 404. Con un mapa de redirecciones 301 de cada URL antigua a su equivalente nueva, el SEO se conserva e incluso mejora por la subida de rendimiento.

¿Cuánto se tarda en migrar una web de October CMS a Astro?

Una web corporativa típica —20 a 40 páginas, un blog y formularios— se migra en dos o tres semanas. Lo que alarga el plazo no es maquetar en Astro, sino auditar el contenido real, decidir qué se queda y montar bien los redirects. Cuanto más limpia esté la estructura de October, más rápido va.

¿Merece la pena migrar o mejor mantengo el October CMS del cliente?

Si el sitio funciona, se actualiza poco y nadie se queja del rendimiento, mantenerlo sale más barato. Migrar tiene sentido cuando el theme es difícil de tocar, el hosting PHP da problemas, los Core Web Vitals están en rojo o el cliente quiere autonomía para publicar sin depender de una instalación frágil.

¿Astro sirve para una web con blog y contenido que cambia?

Sí. Astro gestiona el contenido con colecciones en Markdown o conectando un CMS headless por API. Para una agencia es cómodo: el contenido queda versionado en Git o en un panel headless, y el sitio se sirve estático, rápido y sin servidor PHP que mantener.