Hébergement

• Un site est un nom et une adresse : un site nommé my-app est servi sur https://my-app.espohost.com. Un projet peut avoir plusieurs sites.
• Chaque envoi est un déploiement : une copie de vos fichiers qui ne change jamais. Un site affiche un seul déploiement à la fois, le déploiement en ligne, donc publier une nouvelle version ne modifie jamais une ancienne.
• Espobase sert vos fichiers tels quels et n'exécute pas votre code sur ses serveurs d'hébergement. Pour le travail côté serveur, appelez depuis la page l'API REST de votre projet ou une edge function.

1. Ouvrez votre projet, choisissez Hébergement dans le menu de gauche et créez un site : un nom, une adresse et, pour les apps React, Vue et similaires, l'interrupteur Application monopage.
2. Cliquez sur Publier un dossier et choisissez votre dossier de build, par exemple dist ou out. Les fichiers cachés ne sont jamais envoyés.
3. Votre navigateur calcule l'empreinte de chaque fichier et n'envoie qu'une fois chaque fichier distinct. À la fin de l'envoi, le nouveau déploiement passe en ligne.
4. Ouvrez l'adresse affichée sur la carte du site.

Avec la CLI espobase, publiez un dossier de build en une seule commande :

espobase deploy ./dist --site my-app
# ✓ 42 files · 1.8 MB
# → https://my-app.espohost.com

--message ajoute une note au déploiement, et --no-activate l'envoie sans le mettre en ligne. Pour la CI, créez un jeton avec uniquement l'autorisation Déployer des sites (Paramètres du compte › Développeur) et passez-le en ESPOBASE_TOKEN. Ce jeton peut publier, mais pas supprimer des sites ni modifier leurs paramètres. espobase sites list affiche vos sites.

• Au lieu d'envoyer un dossier, un site peut être compilé depuis un dépôt Git public (GitHub, GitLab, Bitbucket ou Codeberg) contenant un projet Node. Ouvrez la carte du site, choisissez Configurer les builds, saisissez le dépôt et la branche (et, si besoin, le dossier, les commandes et la version de Node, 20 ou 22), puis cliquez sur Compiler maintenant.
• Espobase clone le dépôt, installe les dépendances (selon votre fichier de verrouillage : pnpm, yarn ou npm) et exécute votre commande de build, chaque étape dans un environnement isolé. Le dossier de sortie (dist, build, out, public ou celui que vous indiquez) est publié comme un nouveau déploiement et passe en ligne.
• Un build peut utiliser 2 CPU, 4 GB de mémoire et 10 minutes. L'environnement isolé n'a aucun accès à Espobase et ne contient aucun secret d'Espobase.
• Le journal apparaît sur la carte du site pendant le build et lui reste associé (les 30 derniers builds sont conservés). Un site ne compile qu'une chose à la fois, et vous pouvez annuler un build en attente ou en cours.
• Les builds utilisent les minutes de build de votre offre, arrondies à la hausse pour chaque build. Quand elles sont épuisées, les nouveaux builds attendent le prochain cycle de facturation ; le site déjà publié n'est pas affecté.
• Dans Variables de build, vous pouvez donner des valeurs à votre build comme variables d'environnement. Les valeurs publiques (comme VITE_API_URL) sont affichées dans le tableau de bord ; les secrets sont chiffrés, ne sont plus jamais affichés et sont masqués dans les journaux. Tout ce qu'un build place dans les fichiers du site peut être lu par chaque visiteur, n'utilisez donc pas de secrets dans les variables que les frameworks copient dans le site (noms commençant par VITE_ ou NEXT_PUBLIC_).
• GitHub (Pro et Group) : connectez un compte GitHub dans GitHub dans la barre latérale, puis choisissez GitHub comme source du code dans les paramètres de build du site. Les dépôts privés fonctionnent : Espobase les lit avec l'application que vous avez installée, uniquement pendant le build. Un push sur la branche de production compile et publie votre site, et chaque pull request du même dépôt obtient un aperçu à sa propre adresse (publique, masquée aux moteurs de recherche, supprimée à la fermeture de la pull request). Les pull requests issues de forks ne sont jamais compilées.

• Le HTTPS est automatique. Chaque site a sa propre adresse sous espohost.com.
• /about ouvre about.html et /docs ouvre docs/index.html. Une adresse de dossier sans barre oblique finale redirige vers celle qui en a une.
• Ajoutez un 404.html pour afficher votre propre page introuvable. Sans lui, les visiteurs voient un simple 404.
• Avec Application monopage activé, les chemins qui ne sont pas des fichiers ouvrent index.html, pour que le routeur de votre app les gère. Un fichier absent avec une extension, comme /logo.png, renvoie toujours 404.
• Les navigateurs revérifient vos fichiers à chaque visite (avec un ETag), donc un nouveau déploiement apparaît tout de suite. Les fichiers sous _next/static/ ont un hash de contenu de Next.js et sont mis en cache un an.
• Le type de contenu vient de l'extension du fichier.

1. Ouvrez la carte du site dans Hébergement, choisissez Gérer les domaines et ajoutez votre domaine, par exemple www.votremarque.com.
2. Chez votre fournisseur DNS, publiez les deux enregistrements indiqués : un enregistrement TXT qui prouve que le domaine est à vous (laissez-le en place) et un CNAME de votre domaine vers sites.espohost.com. Un domaine nu comme votremarque.com ne peut pas avoir de CNAME, publiez donc les enregistrements A indiqués.
3. Cliquez sur Vérifier le DNS. Quand l'enregistrement TXT est trouvé, le domaine est vérifié et le certificat HTTPS est émis automatiquement à la première visite, en quelques secondes.
4. Le site répond désormais sur votre domaine et sur son adresse espohost.com. Supprimer un domaine l'arrête aussitôt.
5. Si votre offre compte ensuite moins de domaines, les domaines en trop ne sont plus servis mais sont conservés.

• La bande passante correspond aux données que vos sites envoient aux visiteurs. Elle est comptée par cycle de facturation sur tous les sites de votre organisation, et vous la voyez sur la page Hébergement.
• Vous recevez un e-mail à 75 %, 90 % et 100 % de la bande passante de votre offre. Le trafic supplémentaire n'est jamais facturé.
• Entre 100 % et 125 %, vos sites continuent de fonctionner. Au-delà de 125 %, les visiteurs voient une page « limite de bande passante atteinte » jusqu'au début du prochain cycle de facturation, ou jusqu'à ce que vous passiez à une offre avec plus de bande passante. Rien n'est supprimé.
• Le trafic est additionné chaque minute : la pause commence donc quelques minutes après le dépassement.

• Chaque déploiement est listé sur la carte du site. Choisissez Mettre en ligne sur un plus ancien pour revenir en arrière, ou sur un plus récent pour avancer. C'est instantané, car seul le pointeur change.
• Espobase conserve les 10 déploiements les plus récents de chaque site et supprime automatiquement les plus anciens. Le déploiement en ligne n'est jamais supprimé.
• Les développeurs peuvent publier et revenir en arrière. Les administrateurs créent, renomment et suppriment des sites, modifient le réglage d'application monopage et suppriment des déploiements. Chaque modification est consignée dans le journal d'audit.

• Tout ce que vous publiez est public. Ne mettez pas de secrets dans vos fichiers. La clé publiable est faite pour être publique et vos règles de sécurité au niveau des lignes protègent les données ; ne mettez jamais de clé secrète dans un site.
• Les sites vivent sur espohost.com, un domaine différent d'Espobase, donc un site ne peut pas lire les cookies ni les connexions d'Espobase.
• Chaque fichier envoyé est vérifié avec l'empreinte et la taille que vous avez déclarées, et rien n'est servi qui ne figure pas dans la liste de fichiers du déploiement.

• Free : l'hébergement n'est pas inclus.
• Pro : 10 sites par projet, 10 GB de fichiers hébergés, 1 domaine personnalisé par site, 250 GB de bande passante par mois, 500 minutes de build par mois.
• Group : 50 sites par projet, 100 GB de fichiers hébergés, 5 domaines personnalisés par site, 1 TB de bande passante par mois, 2 000 minutes de build par mois.
• Un déploiement peut contenir jusqu'à 10 000 fichiers, 50 MB par fichier et 500 MB au total. Un envoi qui n'est pas terminé en une heure expire.
• Les fichiers hébergés sont comptés sur toute votre organisation. Si vous passez à une offre avec moins de sites, les sites en trop ne sont plus servis, mais rien n'est supprimé.

• Les apps rendues côté serveur (comme Next.js avec serveur). Les exports statiques fonctionnent dès aujourd'hui.