Despliega tu sitio de Astro en Hostinger

Hostinger es un proveedor de alojamiento web que soporta sitios estáticos y aplicaciones de Node.js.

Esta guía cubre el despliegue de proyectos de Astro tanto estáticos como renderizados en servidor a Hostinger usando hPanel.

Requisitos previos

A Cuenta de Hostinger with an active hosting plan.
- El despliegue de sitios estáticos es compatible con todos los planes que incluyen hPanel.
- El despliegue renderizado en servidor requiere un plan que admita aplicaciones Node.js, como Business Web Hosting o Cloud hosting.
Un proyecto de Astro listo para desplegar.

Despliegue de sitio estático

Los proyectos de Astro usan output: 'static' por defecto, por lo que no se requiere ninguna configuración adicional para desplegar un sitio estático.

Puedes subir el contenido de tu carpeta dist/ a Hostinger usando el Administrador de archivos de hPanel o un cliente FTP.

Subida mediante el Administrador de archivos

Construye tu proyecto de Astro localmente:
- npm
- pnpm
- Yarn
Ventana de la terminal
npm run build
Ventana de la terminal
pnpm build
Ventana de la terminal
yarn build
Inicia sesión en hPanel y abre tu sitio web.
Abre Archivos > Administrador de archivos y navega al directorio public_html.
Sube el contenido de tu carpeta local dist/ dentro de public_html. Puedes arrastrar y soltar archivos, o subir un archivo comprimido y extraerlo allí mismo.
Visita tu dominio para confirmar que tu sitio está en línea.

Subida mediante FTP

En hPanel, ve a Archivos > Cuentas FTP para buscar o crear tus credenciales FTP.
Conéctate a tu cuenta de alojamiento usando un cliente FTP como FileZilla.
Sube el contenido de tu carpeta local dist/ al directorio public_html en el servidor.
Visita tu dominio para confirmar que tu sitio está en línea.

Despliegue renderizado en servidor usando Node.js

Para el renderizado bajo demanda, despliega tu proyecto de Astro como una aplicación de Node.js en un plan de Hostinger que soporte Node.js.

Añadir el adaptador de Node.js

Añade el adaptador de Node.js para habilitar el renderizado bajo demanda con el siguiente comando astro add:

npx astro add node

pnpm astro add node

yarn astro add node

Consulta la guía del adaptador de Node.js para ver opciones de configuración adicionales.

Asegúrate de que tu package.json tenga un script start que ejecute el servidor construido:

{
  "scripts": {
    "start": "node ./dist/server/entry.mjs"
  }
}

Desplegar desde un repositorio Git

Sube tu proyecto de Astro a un repositorio de GitHub, GitLab o Bitbucket.
Inicia sesión en hPanel y ve a Sitios web.
Añade un nuevo sitio web y selecciona la opción de aplicación de Node.js.
Conecta tu proveedor de Git y selecciona tu repositorio y rama.
Configura los ajustes de construcción:
- Build command: npm run build
- Start command: npm run start
Selecciona una versión de Node.js que cumpla con el requisito mínimo de Astro (Node.js 22 o posterior).
Inicia el despliegue. Hostinger instalará las dependencias, ejecutará tu comando de construcción y arrancará la aplicación.

Desplegar subiendo los archivos del proyecto

Construye tu proyecto de Astro localmente, luego sube la carpeta dist/ generada junto con el archivo package.json y el archivo de bloqueo (por ejemplo, package-lock.json).
En hPanel, añade un nuevo sitio web y selecciona la opción de aplicación de Node.js.
Sube los archivos de tu proyecto (o un archivo .zip) usando el Administrador de archivos.
Configura la aplicación:
- Raíz de la aplicación: la carpeta que contiene tu package.json.
- Start command: npm run start
Selecciona una versión compatible de Node.js y arranca la aplicación.