Cómo solucioné un error en GitHub Pages con mi dominio personalizado

Cambié mi repositorio de público a privado en GitHub y, como consecuencia, se desconfiguró el dominio personalizado, ya que la ruta dejó de ser accesible públicamente. Ojo: esto puede dejar tu sitio web estático completamente caído.

Hoy te muestro cómo resolví un problema real con GitHub Pages y el dominio personalizado de mi proyecto ReservaTotal, desplegado desde la rama gh-pages en el directorio /docs.

El problema

Mi sitio reservatotal.anibalcopitan.com no cargaba.

Error 404 GitHub Pages

El repositorio estaba bien configurado, pero GitHub Pages no servía el dominio ni el HTTPS. Mi estructura era así:

/docs
  ├── index.html
  ├── script.min.js
  ├── style.min.css
  ├── CNAME

Todo parecía correcto. El archivo CNAME apuntaba al dominio, y el build estaba en la rama principal. Sin embargo, el sitio seguía sin funcionar.

---

Diagnóstico paso a paso

1. Verifiqué la configuración en GitHub Pages
   • Rama: gh-pages
   • Carpeta: /docs
   • HTTPS: activado
2. Comprobé el archivo CNAME El dominio estaba bien escrito, sin espacios ni caracteres extraños.
3. Comparé con otro proyecto funcional Revisé la configuración de mi otro proyecto: okeypay.anibalcopitan.com Todo estaba igual, así que descarté un problema de DNS o SSL.

---

La solución

El error estaba en el custom domain de GitHub Pages. Tuve que eliminar el dominio desde la configuración del repositorio y volver a crearlo. Apenas lo hice, GitHub actualizó el enlace y regeneró el certificado HTTPS.

Luego de unos segundos, el sitio volvió a estar online:

reservatotal.anibalcopitan.com ✅

Configurando Custom Domain

---

Lo que aprendí

• Si tu sitio en GitHub Pages no responde con tu dominio, revisa:
  • Que el archivo CNAME exista dentro del directorio configurado (/docs).
  • Que el dominio esté correctamente asignado en Settings → Pages.
  • Que no haya conflictos con SSL o configuraciones antiguas.
• A veces, simplemente eliminar y volver a crear el custom domain resuelve todo.

---

En video

---

Conclusión

GitHub Pages es excelente para proyectos estáticos, pero a veces un simple bug en la configuración del dominio puede dejar tu app fuera de línea. Si te pasa lo mismo, sigue estos pasos rápidos: revisa el CNAME, reinicia la configuración y verifica el HTTPS.