DOCUMENTACIÓN

Hosting

Publica el front end de tu app junto a su backend. Sube un sitio ya compilado, obtén una dirección segura al instante y vuelve a una versión reciente con un clic.

← Toda la documentación

Cómo funciona

  • Un sitio es un nombre y una dirección: un sitio llamado my-app se sirve en https://my-app.espohost.com. Un proyecto puede tener varios sitios.
  • Cada subida es un despliegue: una copia de tus archivos que nunca cambia. Un sitio muestra un solo despliegue a la vez, el activo, así que publicar una versión nueva nunca modifica una anterior.
  • Espobase sirve tus archivos tal cual y no ejecuta tu código en sus servidores de hosting. Para el trabajo de servidor, llama desde la página a la API REST de tu proyecto o a una edge function.

1. Publica desde el panel

  1. Abre tu proyecto, elige Hosting en el menú de la izquierda y crea un sitio: un nombre, una dirección y, para apps de React, Vue y similares, el interruptor Aplicación de una sola página.
  2. Haz clic en Publicar una carpeta y elige tu carpeta de compilación, por ejemplo dist o out. Los archivos ocultos nunca se suben.
  3. Tu navegador calcula la huella de cada archivo y sube una sola vez cada archivo distinto. Cuando termina la subida, el nuevo despliegue pasa a estar activo.
  4. Abre la dirección que aparece en la tarjeta del sitio.

2. Publica desde tu terminal o CI

Con la CLI espobase, publica una carpeta de compilación con un solo comando:

espobase deploy ./dist --site my-app
# ✓ 42 files · 1.8 MB
# → https://my-app.espohost.com

--message añade una nota al despliegue y --no-activate lo sube sin activarlo. Para CI, crea un token solo con el permiso Desplegar sitios (Ajustes de la cuenta › Desarrollador) y pásalo como ESPOBASE_TOKEN. Ese token puede publicar, pero no puede eliminar sitios ni cambiar sus ajustes. espobase sites list muestra tus sitios.

Compilar desde Git

  • En lugar de subir una carpeta, un sitio puede compilarse desde un repositorio de Git público (GitHub, GitLab, Bitbucket o Codeberg) que contenga un proyecto Node. Abre la tarjeta del sitio, elige Configurar compilaciones, escribe el repositorio y la rama (y, si hace falta, la carpeta, los comandos y la versión de Node, 20 o 22) y haz clic en Compilar ahora.
  • Espobase clona el repositorio, instala las dependencias (según tu archivo de bloqueo: pnpm, yarn o npm) y ejecuta tu comando de compilación, cada paso en un entorno aislado. La carpeta de salida (dist, build, out, public o la que indiques) se publica como un despliegue nuevo y pasa a estar activa.
  • Una compilación puede usar 2 CPU, 4 GB de memoria y 10 minutos. El entorno aislado no tiene acceso a Espobase ni contiene secretos de Espobase.
  • El registro aparece en la tarjeta del sitio mientras se compila y se conserva con ella (se guardan las últimas 30 compilaciones). Un sitio compila una cosa a la vez, y puedes cancelar una compilación en espera o en curso.
  • Las compilaciones usan los minutos de compilación de tu plan, redondeados hacia arriba por compilación. Cuando se agotan, las nuevas compilaciones esperan al próximo ciclo de facturación; el sitio que ya publicaste no se ve afectado.
  • En Variables de compilación puedes dar valores a tu compilación como variables de entorno. Los valores públicos (como VITE_API_URL) se muestran en el panel; los secretos se cifran, no se vuelven a mostrar y se ocultan en los registros. Todo lo que una compilación pone en los archivos de tu sitio puede leerlo cualquier visitante, así que no uses secretos en variables que los frameworks copian al sitio (nombres que empiezan por VITE_ o NEXT_PUBLIC_).
  • GitHub (Pro y Group): conecta una cuenta de GitHub en GitHub en la barra lateral y elige GitHub como origen del código en los ajustes de compilación del sitio. Los repositorios privados funcionan: Espobase los lee con la app que instalaste, solo durante la compilación. Un push a la rama de producción compila y publica tu sitio, y cada pull request del mismo repositorio tiene una vista previa en su propia dirección (pública, oculta para los buscadores, eliminada al cerrar el pull request). Los pull requests de forks nunca se compilan.

Cómo se sirve tu sitio

  • HTTPS es automático. Cada sitio tiene su propia dirección bajo espohost.com.
  • /about abre about.html y /docs abre docs/index.html. Una dirección de carpeta sin barra final redirige a la que la lleva.
  • Añade un 404.html para mostrar tu propia página de no encontrado. Sin él, los visitantes ven un 404 simple.
  • Con Aplicación de una sola página activado, las rutas que no son archivos abren index.html, para que el enrutador de tu app las gestione. Un archivo con extensión que no existe, como /logo.png, sigue devolviendo 404.
  • Los navegadores comprueban tus archivos en cada visita (con un ETag), así que un despliegue nuevo se ve al instante. Los archivos de _next/static/ llevan un hash del contenido de Next.js y se guardan en caché un año.
  • El tipo de contenido sale de la extensión del archivo.

Tu propio dominio

  1. Abre la tarjeta del sitio en Hosting, elige Gestionar dominios y añade tu dominio, por ejemplo www.tumarca.com.
  2. En tu proveedor de DNS, publica los dos registros que se muestran: un registro TXT que demuestra que el dominio es tuyo (déjalo publicado) y un CNAME de tu dominio a sites.espohost.com. Un dominio raíz como tumarca.com no puede tener CNAME, así que publica los registros A que se muestran.
  3. Haz clic en Comprobar DNS. Cuando se encuentra el registro TXT, el dominio queda verificado y el certificado HTTPS se emite automáticamente en la primera visita, en unos segundos.
  4. El sitio responde ahora en tu dominio y en su dirección de espohost.com. Al quitar un dominio, deja de funcionar al instante.
  5. Si tu plan pasa a tener menos dominios, los sobrantes dejan de servirse pero se conservan.

Ancho de banda

  • El ancho de banda son los datos que tus sitios envían a los visitantes. Se cuenta por ciclo de facturación entre todos los sitios de tu organización y lo ves en la página de Hosting.
  • Recibes un correo al 75%, 90% y 100% del ancho de banda de tu plan. El tráfico extra nunca se cobra.
  • Entre el 100% y el 125% tus sitios siguen funcionando. Por encima del 125%, los visitantes ven una página de "límite de ancho de banda alcanzado" hasta que empieza el próximo ciclo de facturación, o hasta que pases a un plan con más ancho de banda. No se borra nada.
  • El tráfico se suma cada minuto, así que la pausa empieza pocos minutos después de superar el límite.

Versiones y vuelta atrás

  • Cada despliegue aparece en la tarjeta del sitio. Elige Activar en uno anterior para volver atrás, o en uno más nuevo para avanzar. Es instantáneo, porque solo cambia el puntero.
  • Espobase conserva los 10 despliegues más recientes de cada sitio y elimina los anteriores automáticamente. El despliegue activo nunca se elimina.
  • Los desarrolladores pueden publicar y volver atrás. Los administradores crean, renombran y eliminan sitios, cambian el ajuste de aplicación de una sola página y eliminan despliegues. Todos los cambios quedan en el registro de auditoría.

Seguridad

  • Todo lo que publicas es público. No pongas secretos en tus archivos. La clave publicable está hecha para ser pública y tus reglas de seguridad a nivel de fila protegen los datos; nunca pongas una clave secreta en un sitio.
  • Los sitios viven en espohost.com, un dominio distinto de Espobase, así que un sitio no puede leer las cookies ni los inicios de sesión de Espobase.
  • Cada archivo subido se comprueba con la huella y el tamaño que declaraste, y no se sirve nada que no esté en la lista de archivos del despliegue.

Planes y límites

  • Free: el hosting no está incluido.
  • Pro: 10 sitios por proyecto, 10 GB de archivos alojados, 1 dominio propio por sitio, 250 GB de ancho de banda al mes, 500 minutos de compilación al mes.
  • Group: 50 sitios por proyecto, 100 GB de archivos alojados, 5 dominios propios por sitio, 1 TB de ancho de banda al mes, 2.000 minutos de compilación al mes.
  • Un despliegue puede tener hasta 10,000 archivos, 50 MB por archivo y 500 MB en total. Una subida que no termina en una hora caduca.
  • Los archivos alojados se cuentan en toda tu organización. Si pasas a un plan con menos sitios, los sitios sobrantes dejan de servirse, pero no se elimina nada.

Aún no disponible

  • Apps renderizadas en el servidor (como Next.js con servidor). Las exportaciones estáticas funcionan hoy.