Documentation · Premiers pas

Déployer votre première application.

Trois chemins, même résultat : votre application est compilée sur une infrastructure canadienne et mise en ligne à votre-projet.app.canner.ca avec HTTPS. Choisissez celui qui correspond à votre projet aujourd’hui.

Il vous faut une application qui s’exécute localement et un compte Canner gratuit — aucune carte requise. Canner détecte votre cadriciel et le compile pour vous; les trois chemins ci-dessous diffèrent seulement par la façon dont votre code nous parvient.

Ce que vous pouvez déployer

Canner détecte le cadriciel automatiquement — vous configurez rarement quoi que ce soit.

Sites statiques — HTML/CSS/JS pur — aucun package.json; glissez simplement le dossier
Next.js
Vite (React, Vue, Svelte)
Astro
Serveurs Node et applications complètes
Python (FastAPI, Flask, Streamlit, Gradio)
Go, Ruby, PHP et Rust
archive .zip ou .tar.gz de tout ce qui précède

Option 1 — Glisser-déposer

Sans git, sans configuration. Allez à Nouveau projet dans le tableau de bord et déposez votre dossier de projet (ou un .zip / .tar.gz). Canner détecte le cadriciel, installe, compile et déploie. Les téléversements sont plafonnés selon le forfait (voir Forfaits et limites) — et n’oubliez pas d’inclure votre fichier de verrouillage (package-lock.json, pnpm-lock.yaml, …) s’il s’agit d’un projet Node.

Option 2 — Connecter GitHub

Dans Nouveau projet, choisissez Déployer depuis GitHub et installez l’application Canner Deploy sur le dépôt. Chaque poussée vers votre branche de production compile et déploie automatiquement; chaque demande de tirage (PR) obtient son propre URL d’aperçu à branche--projet.app.canner.ca. Les échecs de build sont rapportés à la PR comme statut de commit.

Option 3 — La CLI

Idéale pour déployer depuis un terminal, un pipeline CI ou le terminal intégré d’un outil de codage par IA :

npm install -g @canner-ca/cli

canner login            # paste an API token from Dashboard → Account
canner init             # creates the project + writes canner.json
canner deploy --follow  # uploads, builds, streams the log

--follow diffuse le journal de build et se termine avec le code de statut du build — parfait comme dernière étape d’un pipeline CI. Référence complète des commandes sur la page CLI.

Vous exécutez un serveur? Deux règles

Les sites statiques et les cadriciels standards (Next.js, Astro, Vite) n'exigent aucun changement — Canner s'en occupe. Si votre application exécute son propre serveur :

Écoutez sur $PORT — lisez le port depuis la variable d'environnement PORT.
Répondez sur / dans les 30 secondes suivant le démarrage — cette vérification d'état fait passer votre déploiement à « en ligne ». Définissez un autre chemin dans les paramètres du projet si votre racine n'est pas servable.
const port = process.env.PORT || 3000;
app.listen(port);

La suite

Votre build s’exécute dans un bac à sable isolé avec son propre budget mémoire, puis l’application démarre sous son propre utilisateur Linux et obtient automatiquement un certificat TLS. Sur le forfait gratuit Starter, une application se met en veille après 3 heures sans trafic et se réveille à la prochaine requête; les forfaits payants la gardent toujours active. Ensuite :