Hébergement Next.js : déployer une application Next.js

​

Introduction

​

Prérequis

• Compte Square Cloud : Inscrivez-vous via la page d’inscription en utilisant votre adresse e-mail.
• Plan actif : Garantit des ressources dédiées et des performances optimisées pour votre application. Consultez nos plans disponibles et choisissez celui qui convient le mieux à vos besoins.

​

Créer le projet

npx create-next-app@latest my-app

​

Générer le build de production

npm run build

​

Port et hôte

"scripts": {
  "start": "next start"
}

​

Configurer Square Cloud

RUNTIME=nodejs
START=npm run start
MEMORY=1024
VERSION=recommended
DISPLAY_NAME=My Next.js app
SUBDOMAIN=my-next-app

​

Contenu du ZIP

• .next/, le build de production (Square Cloud supprime .next/cache à l’envoi, vous pouvez donc l’exclure).
• public/, package.json et votre fichier next.config.*.
• squarecloud.app.
• Vos dossiers source (app/ ou pages/) ne sont pas lus par next start, mais les envoyer ne pose aucun problème.

​

Déployer et vérifier

​

Via le tableau de bord

1

Accéder à la page d'upload

Accédez à la page d’upload et téléversez le fichier zip de votre projet.

2

Configurer votre environnement

Après avoir téléversé votre zip, vous devrez configurer le nom, le fichier principal ou l’environnement d’exécution ainsi que d’autres paramètres de votre projet.
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.

3

Déployer votre projet

Enfin, cliquez sur le bouton « Deploy » pour héberger votre projet sur Square Cloud.
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

4

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Dans le tableau de bord, attendez que le statut de votre application affiche « en cours d’exécution » et vérifiez les logs pour détecter d’éventuelles erreurs de démarrage.
Si vous avez déployé un site web ou une API, ouvrez https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.

Votre application ne démarre pas ? Consultez le guide de dépannage pour les causes les plus courantes et leurs solutions.

​

Via la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Erreurs courantes

​

Could not find a production build

​

Déployer à chaque push avec GitHub Actions

name: Deploy Next.js app

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7

      - uses: actions/setup-node@v7
        with:
          node-version: 24

      - uses: squarecloudofc/github-action@v2
        with:
          token: ${{ secrets.SQUARECLOUD_API_KEY }}
          install-only: true

      - run: npm ci && npm run build

      - run: squarecloud commit ${{ vars.SQUARECLOUD_APP_ID }} --restart

​

Prochaines étapes

​

Contactez-nous