Blog · Guides de déploiement

Comment déployer une application Nuxt en 2026 : une commande, un serveur Node et HTTPS

Par l’équipe Pethost · 10 octobre 2026 · Mis à jour le 25 octobre 2026 · 8 min de lecture

Vous avez une application Nuxt qui tourne avec npm run dev, et vous voulez la mettre en ligne à une adresse en HTTPS, avec le rendu côté serveur. Sur Pethost, c’est une seule commande, pethost deploy, lancée dans le dossier qui contient package.json. Elle écrit le Dockerfile à votre place, lance nuxt build et démarre le serveur que le build a écrit. Le starter de Nuxt a été construit et démarré en 53 secondes la première fois.

Ce qu’il faut pour déployer une application Nuxt en 2026

Trois choses : l’application, la commande pethost et un compte Pethost.

L’application est ici ce que laisse la page d’installation de Nuxt, avec le template minimal et npm :

npm create nuxt@latest nuxt-app

Elle écrit nuxt.config.ts, le dossier app/ et un package.json avec ces scripts. Aucun n’est un script de démarrage, et aucun n’est nécessaire :

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

La commande est un seul programme, qui s’installe en une ligne. Toutes ses commandes sont dans la référence de la CLI.

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

Le compte a besoin d’une offre. Si vous n’êtes pas connecté, pethost deploy ouvre votre navigateur et vous connecte. Si vous n’avez pas encore d’offre, la commande vous montre où en choisir une, et attend.

Déployer l’application Nuxt en une commande

Allez dans le dossier qui contient package.json et lancez pethost deploy. Voici l’écran entier, pour le 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. Elle demande une seule chose Le nom du projet, qui est le premier mot de son adresse. Entrée prend le nom du dossier.
2. La machine ne trouve rien à lancer Le dossier part directement sur votre machine, sans node_modules. La ligne avec la croix est sa réponse : un projet tourne à partir d’un Dockerfile ou d’un fichier Compose, et le dossier n’a encore ni l’un ni l’autre.
3. pethost écrit le Dockerfile Il a vu nuxt dans package.json et un script qui lance nuxt build, et envoie le dossier une deuxième fois.
4. La machine le construit et le démarre Elle voit que le serveur écoute sur le 3000 et y envoie l’adresse. Puis pethost interroge l’adresse elle-même, et affiche ce qu’elle a répondu : 200.

Le fichier .pethost indique quel projet est ce dossier. Committez-le avec le Dockerfile, et le prochain déploiement ne demande rien.

Le Dockerfile que pethost écrit pour Nuxt

Voici le fichier tel qu’il a été écrit dans le dossier du starter, en entier :

# 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"]

Ses premières lignes disent ce que pethost a lu dans votre dossier. Trois choses en viennent :

• Le gestionnaire de paquets est celui que nomme votre lockfile : npm, pnpm, Yarn ou Bun.
• La version de Node est celle que nomme .nvmrc ou .node-version, et Node 24 s’il n’y a ni l’un ni l’autre.
• Le démarrage est votre script start si package.json en a un. Le starter n’en a pas, alors le fichier lance ce que nuxt build écrit avec son preset par défaut, le serveur Node : .output/server/index.mjs.

Le starter en marche occupait 30 MB de mémoire. Si la machine ne parvient pas à construire ou à démarrer le Dockerfile écrit par pethost, pethost retire le fichier de votre dossier et dit ce qui a échoué.

Runtime config et variables d’environnement

Nuxt lit sa runtime config dans les variables qui commencent par NUXT_, au démarrage du serveur. Sur Pethost, une variable, c’est une commande. Elle va dans le fichier .env du projet sur la machine, que le service lit et que chaque déploiement suivant conserve :

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

L’application redémarre avec la nouvelle valeur. pethost env liste les noms, et pethost env --show affiche le fichier avec ses valeurs.

Modifier une page et redéployer

Modifiez app/app.vue et lancez la même commande. Le deuxième déploiement du starter a pris 12 secondes, car la machine garde les couches du build et le cache 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

Pour déployer plutôt à chaque push, connectez le dépôt une fois :

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

Pethost ne lit que les dépôts que vous avez donnés à son application GitHub. Si un déploiement tourne mal, pethost rollback remet la version d’avant, et votre machine garde les trois versions qui précèdent l’actuelle. Un agent IA peut faire tout cela pour vous grâce au serveur MCP de Pethost : comment un agent déploie un projet et s’en occupe.

Utiliser votre propre domaine pour l’application Nuxt

Tout nom sous le domaine de votre compte est une adresse d’emblée, en HTTPS. Un domaine qui vous appartient demande une commande et un enregistrement DNS :

pethost domain add app.example.com

La commande affiche l’enregistrement à créer : un CNAME de votre nom vers le nom de votre machine. Le certificat arrive tout seul dès que le nom pointe vers la machine, et se renouvelle tout seul. pethost password place une page de mot de passe devant toute l’application, pour une application qui n’est pas encore publique.

Ce que vous obtenez pour ce prix

Pethost, c’est 9,99 € par mois pour tout ce que vous hébergez, sur 2 vCPU, 3 GB de mémoire et 30 GB de disque. Le serveur du starter en occupait 30 MB de mémoire, alors la machine a de la place pour l’API qu’appelle l’application, sa base de données et vos autres projets. Il n’y a pas de frais par projet et rien n’est facturé à l’usage : le rendu côté serveur n’est pas facturé à la requête.

• 9,99 € par mois pour tous vos projets, rien de facturé à l’usage
• 53 s pour construire et démarrer le starter, la première fois
• 12 s pour le déploiement suivant

Ce qui est déjà fait pour vous : le HTTPS avec des certificats qui se renouvellent tout seuls, les déploiements depuis GitHub, des sauvegardes chaque nuit conservées 14 jours, SSH dans n’importe quel conteneur, et chaque requête comptée, avec les chemins les plus sollicités et le taux d’erreur des 30 derniers jours. La machine est toujours allumée, alors une page n’attend jamais un démarrage à froid. Les offres sont dans la partie tarifs de la page d’accueil.

Les écrans sont des déploiements de l’application que npm create nuxt@latest écrit à partir de son template minimal, avec Nuxt 4.6.1 et pethost 0.2.1, sur une de nos machines de test. Le compte qu’on y voit est celui de l’exemple, sam.

1. Nuxt : installation
2. Nuxt : déploiement
3. Nuxt : runtime config
4. pethost, la ligne de commande de Pethost