Démarrage rapide : déployer votre première app

Ce guide déploie un petit serveur web Node.js pour vous montrer tout le parcours de bout en bout : trois fichiers, un zip et un envoi. Les étapes sont les mêmes pour un bot ou pour un autre langage.

Avant de commencer

Square Cloud est une plateforme payante : un plan actif est requis pour déployer, afin que votre projet tourne sur une infrastructure de qualité production dès le premier jour. Créez votre compte, puis choisissez le plan qui vous convient (voir ce qu’inclut chaque plan).

S'inscrire

Si vous n’avez jamais utilisé Square auparavant, inscrivez-vous pour commencer.

Se connecter

Si vous avez déjà un compte, connectez-vous pour commencer.

Créer le projet

Créez un dossier contenant ces trois fichiers.

Écrire l'application

index.js répond à chaque requête par un court message. Il lit le port et l’hôte dans les variables d’environnement PORT et HOST, que Square Cloud définit à 80 et 0.0.0.0 :

index.js

const http = require("node:http");

const port = process.env.PORT || 3000;
const host = process.env.HOST || "0.0.0.0";

http
  .createServer((req, res) => {
    res.writeHead(200, { "Content-Type": "text/plain" });
    res.end("Hello from Square Cloud!");
  })
  .listen(port, host, () => {
    console.log(`Listening on http://${host}:${port}`);
  });

Lister les dépendances

Tout projet Node.js a besoin d’un package.json : Square Cloud installe les paquets qu’il liste avant de démarrer votre application. Cet exemple n’en a aucun, mais le fichier doit exister et ne peut pas être vide.

package.json

{
  "name": "hello-square",
  "version": "1.0.0",
  "private": true,
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  }
}

Ajouter le fichier de configuration

squarecloud.app indique à Square Cloud quel fichier exécuter, combien de mémoire réserver et quelle version du runtime utiliser. SUBDOMAIN publie l’application comme site web à l’adresse https://<subdomain>.squareweb.app : choisissez un nom que personne n’a encore pris.

squarecloud.app

MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Hello Square
SUBDOMAIN=hello-square-yourname

Chaque champ est expliqué dans la référence du fichier de configuration. L’extension VS Code complète et vérifie ce fichier pendant que vous tapez.

Un site web doit écouter sur le port 80 et l’hôte 0.0.0.0. Un serveur lié à localhost, 127.0.0.1 ou à un autre port (comme 3000 ou 8080) est injoignable, et le site affiche une page de délai d’attente dépassé. Lire PORT et HOST, comme le fait index.js, règle la question sur Square Cloud tout en gardant le port 3000 sur votre machine.

Vous déployez plutôt un bot ? Retirez SUBDOMAIN, ajoutez AUTORESTART=true et gardez le token dans une variable d’environnement, jamais dans le code. Le tutoriel sur les bots Discord détaille un bot complet.

Compresser le projet

Vous déployez avec la CLI ? Passez cette section : squarecloud upload compresse le dossier pour vous.

Sélectionner les fichiers, pas le dossier

Ouvrez le dossier du projet et sélectionnez tout son contenu. squarecloud.app doit se trouver à la racine du zip : si vous compressez le dossier lui-même, les fichiers se retrouvent dans un sous-dossier et le deploy échoue avec MISSING_CONFIG.

Créer le zip

Windows
macOS
Linux

Faites un clic droit sur les fichiers sélectionnés et choisissez Compresser dans un fichier ZIP (Windows 11) ou Envoyer vers → Dossier compressé.

Faites un clic droit sur les fichiers sélectionnés et choisissez Compresser, ou lancez zip -r ../app.zip . dans le dossier.

Vérifier la taille

Le zip peut atteindre 100 Mo. Laissez de côté node_modules, les environnements virtuels et les caches de build : les dépendances sont installées sur le serveur, et ces dossiers sont de toute façon supprimés au deploy.

Déployer

Envoyez le zip depuis le tableau de bord, ou déployez avec une seule commande depuis la CLI.

Via le tableau de bord

Accéder à la page d'upload

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

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.

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.

Téléversement d'une application vers Square Cloud

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

Pour utiliser cette méthode, votre projet a besoin d’un fichier de configuration nommé squarecloud.app à sa racine. Il indique à Square Cloud comment exécuter votre application.

Guide du fichier de configuration

Apprenez comment créer le fichier de configuration squarecloud.app qui définit l’environnement de votre application.

Installer la CLI

Installez la CLI Square Cloud. Si vous l’avez déjà, exécutez la même commande pour la mettre à jour :

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

npm install -g @squarecloud/cli@latest

Se connecter

Exécutez la commande ci-dessous. Elle ouvre votre navigateur : approuvez-y la connexion et la CLI est prête. Il n’y a aucune clé API à copier. Pour les scripts et la CI, consultez Authentification de la CLI.

squarecloud auth login

Téléverser votre projet

Depuis le dossier de votre projet, exécutez la commande ci-dessous. La CLI compresse le dossier courant en zip, sans ce que liste squarecloud.ignore, puis l’envoie :

squarecloud upload

Pour téléverser un zip que vous avez créé vous-même, passez-le avec --file :

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

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Vérifiez le statut et les logs de votre application directement depuis le terminal :

squarecloud app status
squarecloud app logs

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.

Une fois l’application lancée, https://hello-square-yourname.squareweb.app (avec votre sous-domaine) répond Hello from Square Cloud!.

Vous voulez un deploy à chaque push ? Connectez un dépôt GitHub ou utilisez le workflow GitHub Actions.

Étapes suivantes

Fichier de configuration

Chaque champ de squarecloud.app : mémoire, commande de démarrage, sous-domaine et redémarrages automatiques.

Variables d'environnement

Stockez tokens et chaînes de connexion en dehors de votre code.

Dépannage

Corrigez les erreurs d’envoi, les sites qui ne chargent pas et les applications qui ne démarrent pas.

Extension VS Code

Envoyez, commitez et suivez les logs sans quitter votre éditeur.

Guides pour votre langage

Chaque guide couvre le fichier de dépendances, la commande de démarrage et les pièges courants de son runtime.

Services

Dépannage

Runtimes

Plateforme

Changelog

Démarrage rapide : déployer votre première app

Avant de commencer

S'inscrire

Se connecter

Créer le projet

Compresser le projet

Déployer

Via le tableau de bord

Via la CLI

Guide du fichier de configuration

Étapes suivantes

Fichier de configuration

Variables d'environnement

Dépannage

Extension VS Code

Guides pour votre langage

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

​Avant de commencer

S'inscrire

Se connecter

​Créer le projet

​Compresser le projet

​Déployer

​Via le tableau de bord

​Via la CLI

Guide du fichier de configuration

​Étapes suivantes

Fichier de configuration

Variables d'environnement

Dépannage

Extension VS Code

​Guides pour votre langage

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

Avant de commencer

Créer le projet

Compresser le projet

Déployer

Via le tableau de bord

Via la CLI

Étapes suivantes

Guides pour votre langage