GitHub Pages es un servicio de hosting gratuito integrado en GitHub que convierte el contenido de un repositorio —HTML, CSS, JavaScript o archivos generados por Jekyll— en un sitio web accesible públicamente. No necesitas un servidor aparte: GitHub se encarga de servir los archivos directamente desde tu repo.
¿Qué es GitHub Pages exactamente?
GitHub Pages es una función de la plataforma GitHub que permite publicar sitios web estáticos sin costo adicional. Está disponible tanto en cuentas gratuitas como en planes de pago, con ligeras diferencias en visibilidad (repositorio público u organizaciones privadas).
Los casos de uso más comunes son:
- Portafolios personales de desarrolladores o diseñadores.
- Documentación técnica de proyectos open source.
- Blogs generados con Jekyll, Hugo o cualquier generador de sitios estáticos.
- Landing pages o micrositios de campañas.
- Demos de proyectos de frontend (React, Vue, Angular compilados).
Lo que no puedes hacer con GitHub Pages es ejecutar código del lado del servidor: no hay PHP, Node.js con runtime, Python, bases de datos ni sesiones de usuario dinámicas. Es hosting estático puro.
¿Cómo funciona GitHub Pages como hosting?
El proceso de publicación tiene tres pasos principales:
- Repositorio fuente: creas o usas un repositorio en GitHub. Puede ser público (gratis) o privado (requiere plan Team o superior para GitHub Pages).
- Configuración de la fuente de publicación: en Settings → Pages del repositorio indicas qué rama y carpeta publicar (normalmente
maino la ramagh-pages, desde la raíz o desde/docs). - Build y despliegue: GitHub Actions ejecuta el proceso de build (si usas Jekyll u otro generador) y despliega los archivos resultantes. En 1-3 minutos el sitio está activo.
La URL por defecto sigue el patrón https://tuusuario.github.io/nombre-repo. Si el repositorio se llama exactamente tuusuario.github.io, el sitio queda en la raíz: https://tuusuario.github.io. También puedes configurar un dominio personalizado de forma gratuita.
Dominio personalizado y HTTPS
GitHub Pages permite apuntar tu propio dominio (www.tudominio.com o un apex domain) editando los registros DNS y añadiendo un archivo CNAME en el repositorio. GitHub emite y renueva automáticamente el certificado TLS mediante Let's Encrypt, así que el HTTPS no tiene costo extra.
Límites técnicos que debes conocer
GitHub Pages no es un hosting de propósito general. Antes de elegirlo para un proyecto, revisa estos límites publicados por GitHub:
| Límite | Valor |
|---|---|
| Tamaño máximo del repositorio publicado | 1 GB recomendado (sin límite duro oficial, pero sitios >1 GB pueden ser bloqueados) |
| Ancho de banda mensual | 100 GB (soft limit) |
| Builds por hora | 10 builds/hora |
| Archivos por repositorio | Sin límite oficial, pero repositorios muy grandes impactan el rendimiento del build |
| Código del lado del servidor | No permitido (solo estático) |
| Uso comercial | Permitido, pero sin SLA de uptime garantizado |
El límite de 100 GB de ancho de banda mensual es el que más sorprende a los equipos que empiezan a crecer. Si tu sitio estático empieza a tener tráfico alto, puedes superar ese límite y GitHub podría limitar o suspender el servicio sin previo aviso.
¿Cuándo conviene usar GitHub Pages y cuándo no?
GitHub Pages es una buena elección si…
- Tu sitio es completamente estático: HTML/CSS/JS sin backend.
- El tráfico esperado es bajo o moderado (menos de 50 GB/mes).
- Es un proyecto personal, de documentación o un demo técnico.
- Ya usas GitHub para control de versiones y quieres deploy automático sin configurar servidores.
GitHub Pages no es adecuado si…
- Necesitas PHP, Python, Node.js u otro lenguaje del lado del servidor.
- Tu sitio requiere base de datos, autenticación de usuarios o contenido dinámico.
- Es un negocio con necesidad de SLA de disponibilidad garantizada.
- Tienes tienda en línea, formularios que procesan pagos o lógica de backend.
- Esperas más de 100 GB de tráfico mensual.
Para proyectos que superan estas limitaciones, lo más común es migrar a un hosting compartido, VPS o servicio de aplicaciones. Si necesitas orientación para elegir la plataforma correcta según el tipo de proyecto, el equipo de elenlace.com puede ayudarte a evaluar opciones.
Alternativas a GitHub Pages para sitios estáticos
Si GitHub Pages se queda corto, estas plataformas ofrecen hosting estático con límites más generosos o funciones adicionales:
- Netlify: 100 GB/mes en plan gratuito, funciones serverless, formularios integrados, previews por pull request.
- Vercel: enfocado en Next.js y frameworks modernos; funciones serverless, excelente DX.
- Cloudflare Pages: sin límite de ancho de banda en plan gratuito, CDN global de Cloudflare.
- Firebase Hosting: plan gratuito con 10 GB de almacenamiento y 360 MB/día de transferencia; integrado con el ecosistema Google.
Consulta también nuestra sección de comparativas de hosting donde analizamos cada opción con detalle.
Conclusiones clave
- GitHub Pages es un servicio de hosting estático gratuito ideal para portafolios, documentación y demos técnicos.
- No soporta código del lado del servidor: PHP, Python, Node.js y bases de datos quedan fuera.
- El límite de 100 GB de ancho de banda mensual es suficiente para proyectos personales, pero se queda corto en sitios con tráfico elevado.
- Soporta dominios personalizados y HTTPS gratuito mediante Let's Encrypt.
- Para proyectos con backend o con SLA de disponibilidad garantizada, la alternativa es un hosting dedicado o un servicio como Netlify o Cloudflare Pages.
¿Tu proyecto ha superado lo que GitHub Pages puede ofrecer? En elenlace.com te ayudamos a migrar tu sitio a una plataforma de hosting con soporte, rendimiento y escalabilidad para crecer sin interrupciones.
Preguntas frecuentes
¿GitHub Pages es completamente gratis?
Sí, para repositorios públicos no tiene costo adicional. Para publicar un sitio desde un repositorio privado necesitas un plan GitHub Team o superior. Los dominios personalizados y el HTTPS también son gratuitos.
¿Puedo usar WordPress en GitHub Pages?
No de forma nativa. WordPress requiere PHP y una base de datos MySQL/MariaDB, que GitHub Pages no provee. Sin embargo, existen proyectos que exportan un sitio WordPress a HTML estático (como Simply Static) y luego lo publican en GitHub Pages, aunque pierdes la funcionalidad dinámica.
¿GitHub Pages tiene garantía de uptime?
No existe un SLA de disponibilidad publicado para GitHub Pages. GitHub recomienda no usarlo para sitios donde la disponibilidad sea crítica para el negocio. Para uso empresarial con SLA, lo adecuado es un hosting gestionado o un proveedor cloud con acuerdo de nivel de servicio formal.
¿Puedo usar GitHub Pages con un generador de sitios como Hugo o Astro?
Sí. Puedes configurar un workflow de GitHub Actions que construya tu sitio con Hugo, Astro, Jekyll, Eleventy u otro generador, y luego despliegue el resultado en GitHub Pages automáticamente en cada push a la rama principal.
Compara proveedores
Otros proveedores y guías que vale la pena comparar:
