Blog · Guías de despliegue

Cómo desplegar una app Nuxt en 2026: un comando, un servidor Node y HTTPS

Por el equipo de Pethost · 10 de octubre de 2026 · Actualizado 25 de octubre de 2026 · 8 min de lectura

Tienes una app Nuxt que funciona con npm run dev, y quieres ponerla en línea en una dirección con HTTPS, renderizando en el servidor. En Pethost es un comando, pethost deploy, ejecutado en la carpeta que tiene package.json. Él escribe el Dockerfile por ti, ejecuta nuxt build e inicia el servidor que deja el build. El starter del propio Nuxt se construyó e inició en 53 s la primera vez.

Qué necesitas para desplegar una app Nuxt en 2026

Tres cosas: la app, el comando pethost y una cuenta de Pethost.

La app aquí es la que deja la página de instalación de Nuxt, con la plantilla mínima y npm:

npm create nuxt@latest nuxt-app

El comando escribe nuxt.config.ts, la carpeta app/ y un package.json con estos scripts. Ninguno es un script de inicio, y no hace falta ninguno:

"scripts": {
  "build": "nuxt build",
  "dev": "nuxt dev",
  "generate": "nuxt generate",
  "preview": "nuxt preview",
  "postinstall": "nuxt prepare"
}

El comando es un solo programa, que se instala con una línea. Todos sus comandos están en la referencia de la CLI.

curl -fsSL https://pethost.dev/install.sh | sh      # macOS, Linux
irm https://pethost.dev/install.ps1 | iex           # Windows, in PowerShell

La cuenta necesita un plan. Si no has iniciado sesión, pethost deploy abre tu navegador e inicia sesión por ti. Si aún no tienes plan, te muestra dónde elegir uno, y espera.

Despliega la app Nuxt con un comando

Ve a la carpeta que tiene package.json y ejecuta pethost deploy. Esta es la pantalla entera, para el starter:

$ cd nuxt-app
$ pethost deploy
Name it [nuxt-app]:    it will live at https://nuxt-app.sam.pethost.app
✓ Packed 45 files, 450 KB   (left out node_modules)
✓ Uploaded straight to your machine
✗ /compose.yaml: the project directory has no compose.yaml at its root: add one
✓ Nuxt project detected, wrote Dockerfile.
✓ Packed 46 files, 451 KB   (left out node_modules)
✓ Uploaded straight to your machine
✓ Built and started in 53 s
  · wrote compose.yaml for the Dockerfile: the service app, reading .env
✓ app listens on 3000 → https://nuxt-app.sam.pethost.app
  It answers 200.

https://nuxt-app.sam.pethost.app

Wrote .pethost (commit it). Next:   pethost logs -f   ·   pethost open

1. Pregunta una sola cosa El nombre del proyecto, que es la primera palabra de su dirección. Con Enter se queda el nombre de la carpeta.
2. La máquina no encuentra nada que ejecutar La carpeta va directa a tu máquina, sin node_modules. La línea con la cruz es su respuesta: un proyecto se ejecuta desde un Dockerfile o un archivo de Compose, y la carpeta aún no tiene ninguno de los dos.
3. pethost escribe el Dockerfile Vio nuxt en package.json y un script que ejecuta nuxt build, y vuelve a subir la carpeta.
4. La máquina lo construye y lo inicia Ve que el servidor escucha en el 3000 y envía la dirección ahí. Después pethost visita la dirección él mismo e imprime lo que respondió: 200.

El archivo .pethost dice qué proyecto es esta carpeta. Haz commit de él junto con el Dockerfile, y el siguiente despliegue no pregunta nada.

El Dockerfile que pethost escribe para Nuxt

Este es el archivo tal como se escribió en la carpeta del starter, entero:

# Written by pethost deploy for this Nuxt project: Node 24 (no .nvmrc names another),
# npm installs it (package-lock.json), package.json builds it with "nuxt build", node
# runs .output/server/index.mjs (package.json has no start script).
# It is yours now: change it as you like. pethost does not write it again.

FROM node:24
WORKDIR /app

COPY . .

# Every dependency: what builds the project, and may start it, is among the ones for
# development.
RUN --mount=type=cache,target=/root/.npm \
    npm install

RUN npm run build

ENV NODE_ENV=production
CMD ["node", ".output/server/index.mjs"]

Sus primeras líneas dicen qué leyó pethost en tu carpeta. Tres cosas salen de ahí:

• El administrador de paquetes es el que nombra tu lockfile: npm, pnpm, Yarn o Bun.
• La versión de Node es la que nombra .nvmrc o .node-version, y Node 24 donde no hay ninguno de los dos.
• El inicio es tu script start si package.json tiene uno. El starter no lo tiene, así que el archivo ejecuta lo que escribe nuxt build con su preset por defecto de servidor Node: .output/server/index.mjs.

El starter en ejecución ocupaba 30 MB de memoria. Si la máquina no puede construir o iniciar el Dockerfile que escribió pethost, pethost saca el archivo de tu carpeta y dice qué falló.

Runtime config y variables de entorno

Nuxt lee su runtime config de las variables que empiezan por NUXT_ cuando se inicia el servidor. En Pethost una variable es un comando. Va al archivo .env del proyecto en la máquina, que el servicio lee y que cada despliegue posterior conserva:

pethost env set NUXT_PUBLIC_API_BASE=https://api.example.com
pethost env set NUXT_API_SECRET          # asks for the value without showing it

La app se reinicia con el valor nuevo. pethost env lista los nombres, y pethost env --show imprime el archivo con sus valores.

Cambia una página y vuelve a desplegar

Edita app/app.vue y ejecuta el mismo comando. El segundo despliegue del starter tardó 12 s, porque la máquina conserva las capas del build y la caché de npm:

$ pethost deploy
nuxt-app (.pethost)
✓ Packed 47 files · uploaded · built and started in 12 s
  · wrote compose.yaml for the Dockerfile: the service app, reading .env
  · kept the project's x-pethost
  It answers 200.
https://nuxt-app.sam.pethost.app

Para desplegar en cambio con cada push, conecta el repositorio una vez:

pethost github sam/nuxt-app          # from now on, every push deploys itself

Pethost solo lee los repositorios que diste a su GitHub App. Si un despliegue sale mal, pethost rollback vuelve a poner la versión anterior, y tu máquina conserva las tres versiones anteriores a la actual. Un agente de IA puede hacer todo esto por ti a través del servidor MCP de Pethost: cómo un agente despliega y cuida un proyecto.

Usa tu propio dominio para la app Nuxt

Cualquier nombre bajo el dominio de tu cuenta es una dirección desde el primer momento, con HTTPS. Un dominio tuyo lleva un comando y un registro DNS:

pethost domain add app.example.com

El comando imprime el registro que hay que crear: un CNAME de tu nombre al nombre de tu máquina. El certificado llega solo en cuanto el nombre resuelve, y se renueva solo. pethost password pone una página de contraseña delante de toda la app, para una que aún no es pública.

Qué obtienes por el precio

Pethost cuesta 9,99 € al mes por todo lo que alojas, con 2 vCPU, 3 GB de memoria y 30 GB de disco. El servidor del starter ocupaba 30 MB de esa memoria, así que en la máquina queda sitio para la API a la que llama la app, su base de datos y tus otros proyectos. No pagas por proyecto y nada se mide por uso: el renderizado en el servidor no se cobra por petición.

• 9,99 € al mes por todos tus proyectos, nada se mide por uso
• 53 s para construir e iniciar el starter, la primera vez
• 12 s para el despliegue siguiente

Lo que ya está hecho por ti: HTTPS con certificados que se renuevan solos, despliegues desde GitHub, backups cada noche conservados 14 días, SSH a cualquier contenedor y cada petición contada, con los paths más visitados y la tasa de errores de los últimos 30 días. La máquina está siempre encendida, así que una página nunca espera a un arranque en frío. Los planes están en la parte de precios de la página principal.

Las pantallas son despliegues de la app que escribe npm create nuxt@latest con su plantilla mínima, con Nuxt 4.6.1 y pethost 0.2.1, en una máquina de pruebas nuestra. La cuenta que aparece es la de ejemplo, sam.

1. Nuxt: instalación
2. Nuxt: despliegue
3. Nuxt: runtime config
4. pethost, la línea de comandos de Pethost