Despliega tu sitio de Astro en Hostinger

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

Esta guía explica cómo desplegar proyectos de Astro tanto estáticos como renderizados en el servidor, en Hostinger utilizando hPanel.

Requisitos previos

Una cuenta de Hostinger con un plan de alojamiento activo.
- El despliegue de sitios estáticos es compatible con todos los planes que incluyen hPanel.
- El despliegue renderizado en el servidor requiere un plan que admita aplicaciones de Node.js, como Business Web Hosting o Cloud Hosting.
Un proyecto de Astro listo para desplegar.

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

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

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

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

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

Añade el adaptador de Node.js (EN) 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 (EN) para obtener opciones de configuración adicionales.

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

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

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 Node.js.
Conecta tu proveedor de Git y selecciona tu repositorio y rama.
Configura los ajustes de compilación:
- Comando de compilación: npm run build
- Comando de inicio: 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 compilación e iniciará la aplicación.

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