# Host

> Ton site en ligne, déployé à chaque modification.

Chaque page existe en Markdown à la même adresse suivie de `.md`. `llms-full.txt` contient toute la documentation en un seul fichier.

## Démarrer

- [Host](https://host.hgdc.ch/docs/index.md): Host publie tes sites sur ton domaine, avec la CLI Vercel, depuis l'Union européenne.
- [Mettre un premier site en ligne](https://host.hgdc.ch/docs/demarrer/premier-site.md): Du compte à une preview, puis à la production, avec la CLI Vercel, en une quinzaine de minutes.
- [Déployer un site depuis GitHub](https://host.hgdc.ch/docs/demarrer/depuis-github.md): Importe un dépôt GitHub. La branche principale part en production, les autres reçoivent une preview.

## Guides

- [Créer et révoquer une clé d'API](https://host.hgdc.ch/docs/guides/cle-d-api.md): Crée une clé pour la CLI ou ton intégration, choisis sa portée et révoque-la quand elle ne sert plus.
- [Déployer depuis GitHub](https://host.hgdc.ch/docs/guides/deployer-depuis-github.md): Importe un dépôt, suis chaque build dans Host et mets le workflow à jour quand Host le fait évoluer.
- [Déployer avec GitHub Actions, sans l'application](https://host.hgdc.ch/docs/guides/github-actions-sans-application.md): Écris ton propre workflow avec la CLI Vercel, sans passer par l'app GitHub de Host.
- [Déployer un framework](https://host.hgdc.ch/docs/guides/deployer-un-framework.md): Construis ton site avec vercel build, puis envoie le résultat. Astro, Vite, Next.js, SvelteKit, Nuxt et les autres.
- [Déployer un site statique](https://host.hgdc.ch/docs/guides/site-statique.md): Mets un dossier de HTML, CSS et images en ligne en une commande, sans étape de build.
- [Déployer une app dans un monorepo](https://host.hgdc.ch/docs/guides/monorepo.md): Déploie une app qui vit dans un sous-dossier, et plusieurs sites d'un même dépôt.
- [Brancher un domaine](https://host.hgdc.ch/docs/guides/brancher-un-domaine.md): Sers ton site sur ton propre domaine, avec HTTPS automatique, en quelques minutes de configuration DNS.
- [Gérer les variables d'environnement](https://host.hgdc.ch/docs/guides/variables-d-environnement.md): Ajoute des variables par environnement, marque les secrets comme sensibles et applique un changement à ton site.
- [Synchroniser les variables depuis Doppler](https://host.hgdc.ch/docs/guides/synchroniser-doppler.md): Garde tes secrets dans Doppler. Chaque changement arrive dans le projet Host tout seul, et peut redéployer la production.
- [Revenir en arrière, redéployer ou annuler](https://host.hgdc.ch/docs/guides/revenir-en-arriere.md): Remets en ligne une version précédente, relance un build ou annule un déploiement en cours.
- [Inviter une personne dans une organisation](https://host.hgdc.ch/docs/guides/inviter-une-personne.md): Ajoute un collègue à ton organisation depuis Account, et choisis son rôle pour qu'il accède aux projets.
- [Lire les logs](https://host.hgdc.ch/docs/guides/lire-les-logs.md): Suis les requêtes servies par ton site, puis la sortie de tes builds, pour trouver la cause d'une erreur.
- [Migrer un projet depuis Vercel](https://host.hgdc.ch/docs/guides/migrer-depuis-vercel.md): Déplace un projet de Vercel vers Host sans changer tes outils, avec une bascule DNS sans coupure.
- [Dépannage](https://host.hgdc.ch/docs/guides/depannage.md): Les problèmes les plus fréquents avec la CLI, GitHub, les déploiements et les domaines, et comment les résoudre.

## Référence

- [CLI](https://host.hgdc.ch/docs/reference/cli.md): Référence des commandes de la CLI Vercel prises en charge par Host, avec leurs options et leurs exemples.
- [Variables d'environnement](https://host.hgdc.ch/docs/reference/variables.md): Noms, valeurs, environnements, variables réservées et variables sensibles, avec les règles exactes.
- [Domaines](https://host.hgdc.ch/docs/reference/domaines.md): Enregistrements DNS, statuts, usages, codes de redirection et règles de propriété des domaines.
- [vercel.json](https://host.hgdc.ch/docs/reference/vercel-json.md): Les options de vercel.json que Host applique, leurs limites, et ce qui est filtré à la publication.
- [Compatibilité avec Vercel](https://host.hgdc.ch/docs/reference/compatibilite.md): Ce que la CLI et la plateforme prennent en charge aujourd'hui, ce qui est en préversion et ce qui n'existe pas encore.
- [Limites](https://host.hgdc.ch/docs/reference/limites.md): Tailles, débits, quotas et durées de conservation de Host.

## Référence › API

- [Introduction à l'API](https://host.hgdc.ch/docs/reference/api/introduction.md): Adresse de base, authentification par clé, portée des clés, versions des chemins et limites de débit de l'API Host.
- [Erreurs de l'API](https://host.hgdc.ch/docs/reference/api/erreurs.md): Format des erreurs de l'API Host, liste des codes, leur cause et la conduite à tenir.
- [Lire le propriétaire de la clé et l'organisation](https://host.hgdc.ch/docs/reference/api/utilisateur.md): Renvoie la personne qui a créé la clé, puis l'organisation de la clé. Les routes utilisées par la CLI pour se connecter.
- [Projets](https://host.hgdc.ch/docs/reference/api/projets.md): Lister, lire et créer des projets avec l'API Host. Champs de l'objet projet et erreurs.
- [Déploiements](https://host.hgdc.ch/docs/reference/api/deploiements.md): Créer un déploiement, lire son état, suivre ses logs en direct. Corps de requête, champs de l'objet déploiement et erreurs.
- [Envoyer un fichier](https://host.hgdc.ch/docs/reference/api/fichiers.md): Envoyer le contenu d'un fichier à Host, adressé par son empreinte SHA1, avant de créer un déploiement.
- [Lire les variables d'un environnement](https://host.hgdc.ch/docs/reference/api/variables.md): Renvoie les variables d'un environnement au format de vercel pull, avec les règles de visibilité des variables sensibles.

## Concepts

- [Déploiements](https://host.hgdc.ch/docs/concepts/deploiements.md): Preview, production, adresse de production, adresse de déploiement, statuts et retour arrière. Le cycle de vie d'une version de ton site.
- [Organisations et rôles](https://host.hgdc.ch/docs/concepts/organisations-et-roles.md): Une organisation regroupe des personnes, des projets et des clés d'API. Qui peut faire quoi, et où se gèrent les membres.
- [Secrets et coffre](https://host.hgdc.ch/docs/concepts/secrets-et-coffre.md): Comment Host protège les valeurs de tes variables et tes clés d'API, qui peut les lire et ce qui reste dans le journal.
- [Préversion et rendu à la demande](https://host.hgdc.ch/docs/concepts/preversion.md): Ce qui s'exécute en préversion (rendu à la demande, routes d'API, ISR, crons), comment ça se comporte et ce qui reste en ligne.
- [Sécurité et confidentialité](https://host.hgdc.ch/docs/concepts/confidentialite.md): Ce que Host fait pour protéger tes projets, tes secrets, tes sites et les visiteurs, et comment signaler une faille.