Ce guide détaille la création d'un dépôt GIT aussi bien sur votre Hébergement Web que sur votre Serveur Cloud Infomaniak.

Préambule

• GIT et GITHub sont disponibles par défaut sur les 2 supports susmentionnés.

Création du dépôt GIT

Mise en place, sur le serveur:

• le dépôt GIT est sur /git_depot
• le site se trouve dans le dossier /web/[projet] (dans votre serveur FTP)

Lignes de commande à indiquer:

cd
mkdir git_depot
cd git_depot/
git init --bare [projet].git
cd [projet].git
git update-server-info

Envoi du dépôt local sur le serveur

A faire sur le poste en local:

git init
git remote add origin ssh://user@[xxxxx].ftp.infomaniak.com:/home/clients/[123456789]/git_depot/[projet].git
git status
git add .
git commit -a -m "init"
git push --set-upstream origin master
git push

Clonage du site sur le répertoire du serveur

A faire sur le serveur:

cd
cd web
rm -r [projet]/
git clone /home/clients/[123465789]/git_depot/[projet].git [projet]/

Vous arrivez sur cette page car vous avez une redirection Web sur votre domaine qui est mal configurée. Infomaniak n'est pas en mesure d'identifier le chemin correct de cette redirection, vous êtes donc redirigé vers cette page pour vous aider à corriger cette situation.

Vérification de la zone DNS

Afin de rétablir le fonctionnement de votre redirection, il faut dans un premier temps enlever les traces d'une ancienne redirection mal configurée:

1. Accédez à votre zone DNS.
2. Supprimez les enregistrements concernés (prenez connaissance de la liste ci-dessous) qui correspondent à votre redirection.
3. Cliquez sur l'icône ⋮ à droite de l'entrée DNS et sélectionnez Supprimer:
   
   • Vous ne trouverez probablement pas tous les enregistrements cités dans la liste, c'est tout à fait normal.
   • Tout ajout / modification peut prendre jusqu'à 48 heures pour se propager.
4. Recréez la redirection Web.

Liste des enregistrements à vérifier et à supprimer

Les enregistrements DNS peuvent être de type:

• A et qui pointent sur xx.xx.xx.xx (uniquement des chiffres)
• AAAA et qui pointent sur une IP xxxx:xxxx:x:x::x (des chiffres et des lettres)
• TXT dont la chaîne ressemble à “(numéro)|(URL)”
  • par exemple 1|infomaniak.com si votre redirection pointe vers infomaniak.com
• TXT dont la chaîne ressemble à “(lettre)|(texte)”
  • par exemple t|Text, d|Text ou k|Text

Ce guide détaille les ports ouverts disponibles pour les sites Node.js (uniquement) hébergés chez Infomaniak.

Ports ouverts en sortie

Web

• HTTP (tcp/80)
• HTTP alternatif (tcp/8080)
• HTTPS (tcp/443)
• FTP Data (tcp/20)
• FTP Control (tcp/21)

Mail

• POP3 (tcp/110)
• IMAP (tcp/143)
• SMTP submission (+ STARTTLS) (tcp/587)
• SMTPS (tcp/465)
• IMAPS (tcp/993)
• POP3S (tcp/995)

DB

• MySQL (tcp/3306)
• MongoDB (tcp/27017)
• PostgreSQL (tcp/5432)
• Redis (tcp/6379)
• Redis TLS (tcp/6380)
• ElasticSearch (tcp/9200)

Misc

• SSH (tcp/22)
• Git pack transfer (tcp/9418)

Ports ouverts en entrée

• HTTP (tcp/80)
• HTTPS (tcp/443)
• SSH (tcp/22)

Ce guide explique comment résoudre un problème d'installation de certificat SSL (Let's Encrypt ou Sectigo) si vous utilisez Cloudflare avec des règles de sécurité strictes, comme le filtrage par pays ou adresses IP.

Adapter les réglages SSL / geoblocking

Lorsqu'un certificat SSL est demandé via Infomaniak (Let's Encrypt gratuit ou Sectigo), l'autorité de certification doit vérifier que vous êtes bien propriétaire du domaine. Cette vérification peut se faire par HTTP (via des fichiers spéciaux placés sur votre site), DNS ou e-mail :

• Let's Encrypt utilise /.well-known/acme-challenge/.
• Sectigo utilise généralement /.well-known/pki-validation/ (ou DNS / e-mail selon l'option choisie).

Si ces vérifications échouent (par exemple parce que Cloudflare bloque l'accès), le certificat ne peut pas être délivré ou renouvelé. Or, Let's Encrypt ne vérifie plus uniquement depuis un seul endroit. Depuis un certain temps (et plus encore depuis mars 2024), il effectue ses vérifications depuis plusieurs pays en même temps – y compris des nouveaux comme la Suède ou Singapour. Résultat : si l'un de ces pays est bloqué par vos réglages Cloudflare, la demande de certificat peut échouer, même si tout le reste est correctement configuré.

Pire encore : même si vous essayez de faire une exception uniquement pour l'adresse du challenge (.well-known/acme-challenge), cela ne fonctionne pas forcément avec certaines règles Cloudflare. En effet, les règles de blocage par pays ou par IP sont appliquées avant toute exception basée sur des chemins d'URL.

Ajuster le mode SSL/TLS

Dans Cloudflare, utilisez le mode Full ou Full (strict). Ces modes tolèrent temporairement un certificat expiré ou auto-signé, le temps que la validation aboutisse:

Autoriser les chemins de validation

Évitez les "IP Access Rules" bloquantes et préférez des "Custom Rules" qui autorisent sans restriction les chemins :

• /.well-known/acme-challenge/ (Let's Encrypt)
• /.well-known/pki-validation/ (Sectigo)

Désactiver temporairement le geoblocking

Si nécessaire, désactivez provisoirement le blocage géographique ou IP le temps de la validation, puis réactivez vos protections après l'émission ou le renouvellement du certificat.

Infomaniak propose différentes offres Site Creator, gratuites ou payantes, qui répondent à divers besoins. Il est essentiel de bien comprendre les conditions liées à chaque type d'offre avant de faire votre choix.

Comprendre les différentes offres Site Creator

Site Creator est disponible…

• … soit gratuitement avec chaque hébergement Web payant existant (ajoutez-en un si nécessaire):
  
  • Dans ce cas, 1 seul Site Creator peut être mis en place par hébergement Web Infomaniak.
  • Pour gérer plusieurs sites créés avec Site Creator dans la même Organisation, il est donc nécessaire de posséder plusieurs hébergements Web.
• … soit de façon autonome (standalone déclinée en 3 versions) et ne requiert dans ce cas aucune autre offre particulière:
  
  1. Site Creator Free
  2. Site Creator Lite
  3. Site Creator Pro

1. Site Creator Free

Cette offre est positionnée comme une solution de test et de découverte et est entièrement gratuite. Elle s'adresse aux utilisateurs qui souhaitent se familiariser avec l'outil ou publier une page web extrêmement simple:

• Elle n'autorise qu'une seule page web et offre un espace disque réduit (5 Go).
• Cette offre ne permet pas la connexion à un nom de domaine personnalisé (il sera de la forme *.infomaniak.site) et inclut l'affichage obligatoire de la mention publicitaire d'Infomaniak.
• Les modules de croissance importants, tels que la gestion complète d'un blog, l'utilisation de l'Intelligence Artificielle pour la génération de texte, ou la fonction "Plan du site", ne sont pas inclus.

2. Site Creator Lite

Le plan Lite est l'offre d'entrée de gamme payante d'Infomaniak. Il est idéal pour la création d'un site vitrine ou d'un blog personnel simple, car il élimine les principales contraintes de la version gratuite et débloque les modules nécessaires à un site complet:

• Elle permet la création d'un site plus conséquent avec une limite fixée à 6 pages web et un espace disque plus confortable (15 Go).
• Elle inclut l'offre d'un nom de domaine pendant un an et, point essentiel, le retrait de toute mention publicitaire d'Infomaniak sur le site.
• Contrairement à l'offre Free, le plan Lite débloque l'accès à des fonctionnalités importantes pour la navigation et l'organisation, notamment le module de Création et gestion de Blog ainsi que le module Plan du site.

3. Site Creator Pro

L'offre Pro est la formule premium de Site Creator. Elle est exclusivement dédiée aux projets les plus ambitieux, comme le lancement d'une boutique en ligne complète, grâce à la levée de toutes les restrictions de contenu et l'intégration d'outils de commerce et d'analyse avancés:

• Elle supprime toute limitation sur le contenu en offrant des pages web illimitées et un large espace disque de 50 Go.
• C'est la seule offre qui intègre la gestion complète du E-commerce (commandes, stock, réductions) et permet l'intégration des passerelles de paiement essentielles (Stripe, PayPal, Mollie) pour une activité commerciale en ligne.
• Le plan Pro est le seul à donner accès à des outils d'analyse et de suivi de performance externes cruciaux, tels que Google Analytics, Hotjar et les outils comme Google reCaptcha.

Engagement lié aux offres payantes

Contrairement à d'autres produits Infomaniak, certaines offres Site Creator incluent un nom de domaine gratuit. Ces offres nécessitent un engagement ferme d'une durée minimale de 12 mois, sans possibilité de remboursement, même partiel, et ce même si :

• vous décidez de stopper l'utilisation de Site Creator avant la fin de la première année,
• vous résiliez vos produits,
• vous clôturez votre compte utilisateur ou votre Organisation.

Évolution des offres et conservation de votre site

Il est possible de passer d'une offre gratuite à une offre payante plus complète:

1. Cliquez ici afin d'accéder à la gestion de votre site sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur le menu d'action ⋮ à droite du site concerné dans le tableau qui s'affiche.
3. Cliquez sur Modifier l'offre:
   

Il est également possible de passer à une offre supérieure (par exemple, de Lite à Pro).

Si vous souhaitez conserver votre site actif, vous devez impérativement renouveler la même offre payante. Il n'est pas possible de basculer vers une version gratuite de Site Creator, même si :

• vous n'utilisez aucun des modules payants,
• votre site ne comporte qu'une seule page.

Que faire si vous souhaitez revenir à l'offre gratuite ?

Dans ce cas, vous devez :

• résilier votre site actuel après avoir copié manuellement toutes les informations que vous souhaitez conserver,
• activer une nouvelle offre Site Creator gratuite,
• recréer votre site en y collant les contenus récupérés de l'ancien.

Ce guide détaille l'installation et la maintenance de Ghost sur un hébergement Web Infomaniak, afin d'obtenir une plateforme optimisée pour le blogging et la publication éditoriale, une alternative performante à Substack ou Medium.

Prérequis

• Un site de type Node.js (v22 recommandé).
• Un accès SSH actif.
• Une base de données MySQL/MariaDB.
• Arrêter l'application Node.js depuis le dashboard de votre site Node.js avant toute opération technique.

Installation de Ghost

Pour cela:

1. Connectez-vous à votre serveur en SSH (besoin d'aide ?).

2. Exécutez les commandes suivantes pour lancer l'installateur:

   # Clone tools repo
   git clone https://github.com/Infomaniak/hosting-tools.git
   cd hosting-tools/h3-ghost
   # Run installation script
   bash ./install.sh

3. Le script va maintenant :
   • vous poser quelques questions (URL du site, infos de base de données, SMTP, etc.)…
   • télécharger et configurer Ghost automatiquement…
   • prendre quelques minutes — soyez patient !

Répondez aux questions soigneusement en utilisant les détails que vous avez notés. Ne fermez pas le terminal tant qu'il n'a pas fini !

Configuration du Manager (Node.js)

Une fois que le script est terminé, allez dans votre Panneau de contrôle Infomaniak :

1. Cliquez ici afin d'accéder à la gestion de votre site sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au site concerné:
   
3. Cliquez sur Gérer les paramètres avancés:
   
4. Cliquez sur l'onglet Node.js pour accéder aux réglages.

5. Dans le champ de commande d'exécution, entrez:

   /srv/customer/node_modules/ghost-cli/bin/ghost run

6. Vérifiez que le numéro de port est bien 3000.
7. Case de commande de build : désactivez-la.
8. Cliquez sur le bouton Enregistrer en bas de page:
   
9. Sur la page principale, cliquez sur le bouton Start (ou Restart si déjà en cours d'exécution).
10. Confirmez l'opération si nécessaire:
    
11. Observez les journaux montrant la création de la base de données et le démarrage de l'application.

Mise à jour de Ghost

Pour mettre à jour Ghost CMS vers la dernière version ou une version spécifique, suivez ces étapes :

1. Arrêtez l'application Node.js dans le Manager Infomaniak.

2. Accédez au répertoire de votre site Ghost

   # Navigate to your Ghost site directory
   cd ~/sites/ghost-site-name

   Remplacez ghost-site-name par le nom réel de votre dossier (ex: blog, mysite, etc.).

3. Assurez-vous que les permissions des fichiers sont correctes (l'opération peut prendre plusieurs minutes):

   # Ensure file permissions are correct
   find ./ -type d -exec chmod -v 00775 {} \;

4. Vérifiez les mises à jour disponibles :

   # Check available ghost updates
   /srv/customer/node_modules/ghost-cli/bin/ghost check-update

   Pour la dernière version (l'opération peut prendre plusieurs minutes):

   # Update to the latest version
   /srv/customer/node_modules/ghost-cli/bin/ghost update

   Pour une version spécifique comme la v5 (l'opération peut prendre plusieurs minutes):

   # Update to a specific version (e.g., v5)
   /srv/customer/node_modules/ghost-cli/bin/ghost update v5

   • Pourquoi passer par la v5 ? Si vous utilisez Ghost v4 et souhaitez passer à la v6, Ghost nécessite de passer par la v5 comme étape intermédiaire. C'est indispensable pour les montées de version majeures.
5. Patientez jusqu'à ce que la mise à jour soit terminée, puis redémarrez l'application depuis le dashboard du site pour appliquer la mise à jour.

Terminé ! Accédez à votre blog Ghost

Rendez-vous ensuite sur l'URL de votre site pour démarrer:

1. Ouvrez votre navigateur et allez à https://domain.xyz/ghost (remplacez domain.xyz par votre domaine actuel).
2. La première fois :
   1. Vous créerez un compte administrateur (votre identifiant pour le blog)…
   2. Ensuite, vous pourrez commencer à écrire des articles !

Configuration des utilisateurs / mail

Afin de créer le premier utilisateur, ajoutez /ghost à l'URL de votre site (par exemple https://ghost.domain.xyz/ghost) et suivez l'assistant.

Vous pouvez également configurer l'"adresse de support du portail des membres": lorsque de nouveaux membres souhaitent s'inscrire, le portail envoie la confirmation du double opt-in à partir d'une adresse spécifique.

Par défaut, il s'agit de l'adresse “noreply” de votre domaine. Pour la mettre à jour, naviguez vers “Paramètres”, “Adhésion”, “Paramètres du portail”, “Personnaliser”, et “Page du compte”:

Résoudre une incompatibilité technique entre Ghost et MariaDB

Certaines requêtes SQL provoquent des erreurs HTTP 400 sur MariaDB, il en résulte ce type d'erreur:

[2025-01-01 12:54:28] ERROR "GET /ghost/api/admin/posts/6834625e35802b06f1496305/?formats=mobiledoc%2Clexical&include=tags%2Cauthors%2Cauthors.roles%2Cemail%2Ctiers%2Cnewsletter%2Ccount.conversions%2Ccount.clicks%2Csentiment%2Ccount.positive_feedback%2Ccount.negative_feedback" 400 27ms
Could not understand request.
Error ID:
8f2b0d90-3a30-11f0-a25f-fd9c83e1cf02
Error Code:
ER_BAD_FIELD_ERROR
----------------------------------------
Error: select `posts`.*,
...

Si besoin, un correctif existe pour adapter le comportement de Ghost.

Pour utiliser ce patch, entrez cette commande :

# Enter the current version folder and apply the MariaDB patch
cd current
curl -L https://gist.githubusercontent.com/reneluria/8cbbfbc001e542c77d6d5887fbafe5d3/raw/65e0ce31753b4687d0eb67fc030734a35d3ffbad/ghost-post.patch | patch -p0

Ce guide permet de résoudre un problème sur le CMS Prestashop et plus particulierement avec son module “Recherche à facette” ("Faceted search") qui permet la gestion de filtre dans les pages catégorie de produits.

Le problème

Ce module de recherche spécifique de Prestashop crée un cache en base de données pour accélérer la recherche, cependant la table correspondante n'est jamais nettoyée, ce qui pose problème à l'infrastructure d'hébergement.

Première solution

Le première solution consiste à désactiver la mise en cache proposée.

Pour cela:

1. Dans le panneau d'administration PrestaShop, rendez-vous dans Modules → Gestionnaire de modules.
2. Sélectionnez Modules et utilisez le champ de recherche pour trouver “facet”.
3. Cliquez sur Configurer à côté du module obtenu en résultat:
   
4. Désactivez le bouton à ce sujet:
   

Seconde solution

La seconde solution consiste à mettre un cronjob qui permet de nettoyer la table, par exemple toutes les soirs:

1. Depuis les paramètres du module, copiez l'URL existante sur le bouton Clear cache:
   

Puis depuis le Manager Infomaniak, créez un webcron (prenez connaissance de cet autre guide à ce sujet) afin d'exécuter l'URL copiée au point 1 ci-dessus, par exemple 1 fois par jour et par nuit.

Ce guide concerne le module Drupal "Infomaniak_Connect" qui permet aux utilisateurs de se connecter à votre site Drupal (qu'il soit hébergé par Infomaniak ou pas) en utilisant leurs identifiants Infomaniak.

Préambule

• Autoriser la connexion via un compte Infomaniak sur votre site Drupal permet à vos visiteurs de commenter, de s'inscrire à des cours ou d'accéder à tout contenu réservé aux membres en un seul clic, sans avoir à créer un nouveau compte.
• C'est un gain de temps pour eux et une méthode plus sûre pour vous, car vous n'avez pas à gérer de mots de passe supplémentaires.
• Le fonctionnement de ce module externe est identique aux options "Se connecter avec Google", "Se connecter avec Facebook" ou “Se connecter avec Apple” ; il utilise les protocoles standard OAuth2 et OpenID Connect pour permettre une authentification unique (SSO).

A. Créer une application avec Auth Infomaniak

Pour cela:

1. Cliquez ici afin d'accéder à la gestion de votre produit Auth sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur le bouton pour Créer une nouvelle application:
   
3. Choisissez le type “Web Front-End”.
4. Donnez un nom à votre application.
5. Dans le champ URL, indiquez le nom de domaine correspondant à votre site Drupal après lequel vous ajoutez /openid-connect-authorize (prenez connaissance de la documentation github si nécessaire).
6. Cliquez sur le bouton pour terminer la création de l'app:
   
7. Notez précieusement les 2 informations obtenues lors de la finalisation de votre application OAuth2:
   

B. Configurer l'extension Drupal

En SSH, déployez si nécessaire Composer pour pouvoir rapatrier les extensions openid_connect et infomaniak_connect. Pour cela:

• Vous devez si nécessaire éditer le fichier composer.json car la version de openid_connect n'est pas encore considérée comme stable. Ajoutez:

• "minimum-stability": "dev",
  "prefer-stable": true

• Les commandes SSH pour l'installation des 2 extensions sont ici:
  • https://www.drupal.org/project/openid_connect
  • https://www.drupal.org/project/infomaniak_connect

Ensuite, sur Drupal:

1. Recherchez le module Infomaniak parmi vos modules préinstallés.
2. Sélectionnez-le.
3. Cliquez sur le bouton Installer:
   
4. L'installation des dépendances va se faire:
   
5. Sous Configuration, cliquez pour paramétrer la connexion OpenID:
   
6. Cliquez sur le bouton d'édition:
   
7. Les seuls champs à remplir sont Client ID et Client Secret et proviennent des informations obtenues au point A ci-dessus:
    
8. N'oubliez pas d'enregistrer les modifications apportées aux réglages de l'extension.
9. Dans l'onglet Paramètres, vous pouvez choisir le type d'affichage pour votre page de connexion ; n'oubliez pas de sauvegarder:
   
10. Un bouton supplémentaire, pour une connexion par identifiant Infomaniak, est désormais visible sur votre page de connexion destinée aux utilisateurs:
     

Ce guide explique pourquoi il est important d'utiliser une version récente de Node.js pour votre application et comment sélectionner une version plus récente avec un site Node.js hébergé sur l'infrastructure Infomaniak.

Préambule

• Node.js = nom officiel du langage/environnement.
• NodeJS = nom "technique" ou simplifié dans certains contextes (souvent pour des raisons pratiques, pas de vraie différence technique).

Une version obsolète de Node.js est-elle dangereuse ?

Lorsque vous utilisez une version de Node.js qui approche de la fin de son support, un message d'avertissement s'affiche dans le tableau de bord du site concerné.

Le runtime Node.js évolue régulièrement : chaque nouvelle version apporte des améliorations de performance, de sécurité et de prise en charge des fonctionnalités récentes. Utiliser une version qui n'est plus tenue à jour vous expose à des risques de sécurité et à des problèmes de fonctionnement avec d'autres composants. Des personnes malveillantes pourraient exploiter des failles connues dans ces versions pour compromettre votre application. Il est donc vivement recommandé d'utiliser une version récente et officiellement supportée.

Trois situations sont possibles :

• Version pleinement supportée‍ : aucune action nécessaire
• Version avec support de sécurité uniquement‍ : il est recommandé de passer à une version plus récente
• Version obsolète‍ : il est vivement recommandé de mettre à jour vers une version plus récente

Utiliser une version plus récente de Node.js

Les versions les plus récentes de Node.js offrent de meilleures performances et un comportement plus stable pour vos applications modernes.

Avant de modifier la version utilisée

• Si votre application utilise un framework ou une bibliothèque spécifique (Next.js, Express, etc.), vérifiez la bonne prise en charge de la version ciblée de Node.js.
• Si votre code a été développé sur mesure, prenez connaissance de la documentation officielle de Node.js pour identifier les changements apportés (API dépréciées, gestion des modules, etc.).

Et si un problème survient ?

Si votre application ne fonctionne pas correctement après avoir changé la version de Node.js, vous pouvez revenir à une version antérieure (si elle est toujours supportée) via l'onglet Paramètres avancés du site concerné.

Ce guide explique comment ajuster la configuration d'un site Node.js hébergé sur l'infrastructure Infomaniak. Vous apprendrez à adapter le comportement de votre application en fonction de son évolution, de ses dépendances ou de vos préférences techniques.

Prérequis

• Installer un site Node.js sur votre hébergement.
• Tester vos modifications en local avant de les appliquer en production.
• Vérifier que vos scripts (start, build) sont bien définis dans votre fichier package.json.
• Si vous modifiez la structure de votre projet, pensez à ajuster le dossier d'exécution et les commandes associées.
• Important : le port d'écoute défini dans le Manager doit impérativement correspondre à celui utilisé dans le code de l'application.

Accéder à la configuration

Chaque site dispose d'un tableau de bord dédié pour contrôler l'application (start, stop, restart), consulter les logs d'exécution, gérer les versions de Node.js et activer les certificats SSL :

1. Cliquez ici afin d'accéder à la gestion de votre site sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au site concerné:
   
3. Cliquez sur Gérer les paramètres avancés :
   
4. Cliquez sur l'onglet Node.js pour accéder aux réglages :
   

Commandes et automatisation

Dossier d'exécution

Le dossier d'exécution indique l'emplacement sur le serveur où seront exécutées les commandes de construction (build) et de lancement. Il doit pointer vers le répertoire racine de votre application, là où se trouve votre fichier package.json.

./          // Root directory
./app       // Subfolder named app
./backend   // Subfolder named backend

Commande de construction (Build)

Si votre application nécessite une étape de préparation (installation des dépendances, compilation TypeScript, minification), renseignez ici la commande à exécuter. C'est la méthode recommandée pour déployer vos mises à jour.

Contrairement à une exécution manuelle en SSH, cette interface utilise un environnement aux performances boostées pour garantir une construction rapide sans impacter les ressources de votre site en production. Vous pouvez y enchaîner plusieurs tâches (comme un git pull suivi d'un build) et suivre l'avancement ainsi que les logs du processus en temps réel directement depuis le Manager.

# Example: install dependencies and build
npm install && npm run build

# Example: update code and build with yarn
git pull && yarn install && yarn build

Note : Si votre projet est déjà compilé ou ne nécessite aucune étape intermédiaire, ce champ peut rester vide.

Commande de lancement

Cette instruction démarre votre serveur. Elle doit être identique à celle utilisée dans votre environnement de développement local pour lancer le point d'entrée de l'application.

# Option 1: Direct file launch
node index.js

# Option 2: Using npm script
npm start

# Option 3: Using yarn script
yarn start

Port d'écoute

Votre application doit impérativement écouter sur le port dynamique attribué par le Manager. Ce port est transmis à votre code via la variable d'environnement PORT.

// Use the port provided by the environment
const port = process.env.PORT || 8080;

app.listen(port, () => {
  console.log(`Application started on port ${port}`);
});

Version de Node.js

Vous pouvez sélectionner la version de Node.js souhaitée dans les réglages. Il est conseillé de privilégier une version stable (LTS) pour assurer la sécurité et la pérennité de votre projet.

Appliquer et valider les changements

Une fois vos modifications enregistrées dans le Manager, vous devez redémarrer votre application depuis le tableau de bord pour que les nouveaux paramètres (nouvelle version de Node, nouveau port ou nouvelle commande de build) soient pris en compte.

En cas de difficulté au démarrage, vous pouvez consulter la console d'exécution ou vous référer à cet autre guide pour un dépannage.

Ce guide vous aide à diagnostiquer rapidement l'origine d'un problème si votre site Node.js, hébergé sur l'infrastructure Infomaniak, ne fonctionne pas comme prévu.

Vérifier le statut de l'application

Depuis le dashboard de votre site Node.js, vous pouvez consulter l'état actuel de l'application :

• Actif : votre application fonctionne normalement.
• En cours de redémarrage : l'application redémarre, attendez quelques instants.
• Arrêtée ou En erreur : il y a un problème.

Dans le cas d'une erreur ou d'un arrêt :

• Cliquez sur « Lancer » ou « Redémarrer » l'application.
• Consultez immédiatement la console d'exécution pour identifier d'éventuelles erreurs techniques.

Lire la console d'exécution

La console affiche les messages d'erreur générés lors du lancement de votre application. Voici les erreurs fréquentes :

• Commande de lancement incorrecte : vérifiez que vous utilisez bien la bonne syntaxe (exemple : npm start, node app.js, etc.).
• Erreur dans le code source : il peut s'agir d'une exception non gérée, d'un module manquant ou d'un port incorrectement défini.

Vérifier les paramètres de l'application

Dans la section Paramètres avancés du site, assurez-vous que tous les réglages sont corrects :

• Dossier d'exécution : dossier dans lequel sont lancées les commandes build et start.
• Commande de construction (optionnelle) : par exemple npm run build si votre app en nécessite une.
• Commande de lancement : par exemple node index.js, npm start, etc.
• Port d'écoute : le port sur lequel l'application attend les requêtes (par exemple 8080, 3000, etc.).
  • Le port configuré dans votre application doit correspondre à celui défini dans le Manager.
• Version de Node.js : assurez-vous qu'elle est compatible avec votre code.

Infomaniak met à disposition les gestionnaires de paquets NPM et Yarn. Vous pouvez choisir celui qui correspond à votre projet dans l'assistant de configuration.

Toujours bloqué ?

Le site reste inaccessible ?

• Votre application est peut-être en mode maintenance.
• Le port d'écoute de l'application peut être incorrect ou bloqué.
• L'application ne renvoie pas de réponse HTTP correcte (pas de res.send() ou res.end() dans votre serveur par exemple).

Vous avez utilisé une méthode avancée d'installation ?

Si vous avez importé votre code via Git, ZIP, SSH ou SFTP, assurez-vous que :

• Le code a bien été décompressé ou cloné dans le bon dossier.
• Les fichiers essentiels (package.json, server.js, index.js, etc.) sont présents.
• Les dépendances sont bien installées (node_modules présent après npm install ou yarn install).

Si le problème persiste après toutes ces vérifications :

• Essayez de créer un nouveau site avec la méthode simple pour tester avec un exemple fonctionnel.
• Comparez votre configuration avec celle de l'exemple fourni.
• Prenez connaissance de la documentation officielle de Node.js pour des erreurs spécifiques.
• En cas de besoin, contactez le support Infomaniak avec une copie des logs affichés dans la console.

Les sites Node.js proposés par Infomaniak permettent d'exécuter des applications Node.js dans un environnement flexible, prêt à l'emploi, sans avoir à gérer une infrastructure serveur.

Préambule

• Offrant la souplesse d'un serveur sans la complexité de son administration, ce type d'hébergement est particulièrement adapté aux projets API REST, pour déployer le CMS Ghost, n8n, Strapi ou des frameworks comme Express.js, NestJS ou encore socket.io, next.js, outils métiers ou prototypes pour:
  • développeurs souhaitant déployer des applications Node.js sans gérer d'infrastructure.
  • webmasters cherchant à expérimenter ou à se former à Node.js.
  • agences et freelances travaillant sur plusieurs projets clients.
  • étudiants, enseignants et écoles nécessitant un environnement simple pour tester du code.
• Les gestionnaires de paquets NPM et Yarn sont pris en charge.
• Si vous installez Node.js sur un hébergement Web au sein d'un Serveur Cloud, votre site ne fonctionnera pas avec les ressources garanties du Serveur Cloud managé.
  • Prenez connaissance de cet autre guide pour utiliser Fast Installer et déployer NVM.
• Node.js = nom officiel du langage/environnement ; NodeJS = nom "technique" ou simplifié dans certains contextes (souvent pour des raisons pratiques, pas de vraie différence technique).

Créer un site Node.js

Pour accéder à un plan d'hébergement Web et y ajouter un site Node.js:

1. Cliquez ici pour accéder à la gestion de vos hébergements dans le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué à l'hébergement concerné:
   
3. Cliquez sur le bouton bleu Ajouter:
   
4. Choisissez un projet avec technologies avancées.
5. Cliquez sur Suivant:
   
6. Choisissez Node.js.
7. Sélectionnez une éventuelle autre version si nécessaire.
8. Cliquez sur Suivant:
   
9. Choisissez le type de domaine à attribuer à ce nouveau site :
   1. un nom de domaine déjà acquis
   2. un sous-domaine créé à partir d'un nom de domaine déjà acquis
   3. un nom de domaine encore disponible et à commander
10. Entrez le nom de domaine ou le sous-domaine.
11. Choisissez les options avancées éventuelles.
12. Cliquez sur Suivant:
    
13. Choisissez l'une des deux approches possibles:
    
    1. Méthode rapide:
       • Un projet d'exemple préconfiguré est automatiquement installé.
       • Cette approche est idéale pour découvrir Node.js ou démarrer rapidement une base fonctionnelle.
    2. Méthode personnalisée:
       • Le code source peut être importé via archive ZIP, SSH ou SFTP.
       • Vous pouvez également choisir d'utiliser des dépôts publics hébergés sur GitLab, GitHub ou toute autre plateforme compatible avec Git.
       • Les dépôts privés sont également pris en charge au moyen d'une authentification HTTP Basic: https://username:password@github.com/…
       • Vous définissez vous-même les scripts, points d'entrée, port d'écoute, et commandes de build nécessaires.
14. C'est terminé, le site est prêt:
    

Chaque site dispose d'un tableau de bord dédié pour contrôler l'application (start, stop, restart), consulter la console d'exécution, gérer les versions de Node.js, configurer les domaines et activer les certificats SSL:

Pour aller plus loin dans la configuration de votre site Node.js, prenez connaissance de cet autre guide.

Ce guide explique comment importer des données externes (fichiers, dossiers, etc.) vers votre kDrive en utilisant le protocole WebDAV fourni par votre hébergeur Cloud.

Préambule

• Prenez connaissance de cet autre guide si vous recherchez des informations pour copier des données précises d'un kDrive vers un autre lorsque votre utilisateur dispose d'un accès aux 2 kDrive concernés.

Importer des données externes par WebDAV

Prérequis

• Posséder une offre kDrive ou kSuite
• Avoir des permissions suffisantes au sein de kDrive ou kSuite.
• Ne pas changer de mots de passe tant que l'importation n'est pas terminée !

Pour accéder à l'outil d'importation, là où les données doivent être importées:

1. Cliquez ici afin d'accéder à l'app Web kDrive Infomaniak (service en ligne ksuite.infomaniak.com/kdrive).
2. Cliquez sur l'icône Paramètres ‍ en haut à droite.
3. Vérifiez ou sélectionnez le kDrive concerné dans le menu déroulant du menu latéral gauche.
4. Cliquez sur Général dans le menu latéral gauche.
5. Cliquez sur Importer des données externes:
   
6. Cliquez le bouton bleu Démarrer:
   
7. Cliquez sur WebDAV.
8. Complétez les informations demandées en fonction de la source (notamment l'adresse WebDAV en votre possession - obtenue à la source).
9. Choisissez le kDrive de destination et l'emplacement souhaité pour accueillir les données importées.
10. Cliquez sur Démarrer:
    

Ce guide détaille les règles spécifiques à respecter lors de la création d'un mot de passe utilisateur avec mysqli_connect() qui contient le caractère “dollar” $ sur les plateformes Infomaniak.

Préambule

• Si lors de l'utilisation de mysqli_connect(),  vous obtenez le message d'erreur "Access denied for user" et que votre mot de passe d'utilisateur de base de données contient un signe $, le problème peut venir du fonctionnement des chaînes de caractères en PHP.
• Le problème peut également survenir avec des scripts de messagerie.

Règles à respecter

Lorsque est utilisé le caractère spécial $ dans un mot de passe utilisateur et que celui-ci est suivi par tout autre caractère qu'un nombre, le nom de la variable n'est pas valide et la substitution ne se fait pas correctement.

Voici des solutions pour corriger cela:

• Placez le mot de passe entre guillemets simples : '$******'
• Assurez-vous qu'un nombre suit directement le dollar :  "$2*****"
• Utilisez un anti-slash pour "échapper" le dollar dans le mot de passe : “\$****”

Ce guide explique quelles sont les différences entre un Domaine (ou site principal), un Sous-domaine et un Alias.

Préambule

• Bien qu'ils soient liés, ces trois éléments (Domaine, Sous-domaine et Alias) ont des fonctions et des finalités différentes.
• Ils peuvent impacter un Hébergement Web via son nom de domaine, ou même la messagerie puisqu'il est tout à fait possible d'avoir des adresses mail sur un sous-domaine par exemple.

Qu'est-ce qu'un Domaine ?

Le domaine ou nom de domaine, est la porte d'entrée principale à votre site Web. C'est à partir de lui que vos utilisateurs accéderont à votre contenu. C'est ce domaine principal qui définit ce qui apparaîtra dans la barre URL des navigateurs de vos utilisateurs.

Prérequis

• Posséder un domaine.
• Posséder un hébergement Web Infomaniak.

Prenez connaissance du guide Créer un nouveau site sur votre hébergement Web.

Qu'est-ce qu'un Sous-domaine ?

Le Sous-domaine est symbolisé par un mot supplémentaire qui se trouve devant votre nom de domaine principal. Cela est très utile dans plusieurs cas, par exemple :

• cela peut servir à afficher du contenu "exclusif" ou ciblé, par exemple en vous rendant sur faq.infomaniak.com vous arrivez sur la base de connaissance où se trouvent tous les guides
• cela peut également servir (temporairement ou définitivement) lors de la création d'un nouveau site ou de la refonte d'un site existant, en créant par exemple new.domain.xyz quand le site principal était jusqu'alors domain.xyz

Prérequis

• Posséder au moins un domaine.
• Posséder un hébergement Web Infomaniak.

Prenez connaissance du guide Ajouter un sous-domaine à votre hébergement Web.

Qu'est-ce qu'un Alias ?

Un Alias ou Domaine Alias est un second nom de domaine qui pointe directement sur votre site principal, ; que ce soit en passant par le domaine lié ou par le domaine principal, ils partagent les mêmes pages Web. L'alias est une autre porte d'accès à votre site Web. Par exemple le site principal de la confédération helvétique est www.ch.ch et www.suisse.ch est son alias. 

Prérequis

• Posséder plusieurs noms de domaine.
• Posséder un hébergement Web Infomaniak.

Prenez connaissance du guide Ajouter un alias à votre hébergement Web.

L'équivalent existe également pour un Service Mail.

L'intérêt d'un Alias est de vous permettre d'augmenter la visibilité de votre site auprès de votre cible en lui proposant davantage de porte d'entrées pour y accéder.

Ce guide détaille les plages d'adresses IP publiques utilisées par Infomaniak ; ceci facilite notamment la configuration des systèmes de sécurité (firewall, filtrage, whitelisting).

Préambule

• Les adresses sont indiquées au format CIDR (exemple : 192.0.2.0/24), qui regroupe plusieurs adresses consécutives.
• Le format du listing inclut les plages IP (ranges) utilisées par les produits suivants :
  • kuite : tous les produits kSuite
  • vps : tous les VPS
  • public-cloud : tout le Public Cloud
  • all : englobe toutes les IP du réseau Infomaniak

Plages d'adresses IPv4 & IPv6

Le lien vers le fichier JSON répertoriant les IP est :

https://prefixes.infomaniak.com/json

Ce guide explique comment créer et gérer une application OAuth2/OpenID Connect (OIDC) afin de permettre à une application tierce d'utiliser votre identifiant de connexion Infomaniak pour authentifier les utilisateurs et accéder, avec leur autorisation, aux ressources prévues par les autorisations (scopes) accordées.

Préambule

• Une application OAuth2 est notamment utilisée pour mettre en place un mécanisme de connexion unique (Single Sign-On) ou pour autoriser un logiciel à accéder à certaines données sans avoir à transmettre le mot de passe du compte.

Gérer les applications OAuth2 Infomaniak

Pour créer une nouvelle application OAuth2 :

1. Cliquez ici pour accéder à la gestion de vos applications OAuth2 sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur le bouton bleu Créer une nouvelle application :
   
3. Choisissez le type d'application correspondant à votre projet. Ce choix détermine notamment le flux d'authentification OAuth2 utilisé.
4. Donnez un nom à l'application afin de l'identifier facilement dans le Manager.
5. Renseignez l'URL de l'application conformément à sa configuration technique (par exemple son URL publique ou son URL de redirection, selon le type d'application).
6. Cliquez sur le bouton permettant de créer l'application :
   
7. Conservez le Client ID et le Client secret dans un endroit sûr.
   • Ces identifiants permettent à votre application de s'authentifier auprès des services Infomaniak.
   • Pour des raisons de sécurité, le Client secret n'est affiché qu'une seule fois lors de sa création:
     
   • Vous pouvez toutefois renouveler la phrase secrète depuis la page principale.

Ce guide explique comment supprimer un site d'un Hébergement Web.

Préambule

• Une fois retiré, le site n'apparaitra donc plus sur Internet à son URL précédente.
• Le quota de sites à disposition sur votre hébergement regagnera un emplacement de libre.

Retirer un site d'un hébergement Web payant

Afin d'accéder aux Hébergements Web pour y retirer un site :

1. Cliquez ici afin d'accéder à la gestion de votre hébergement sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué à l'hébergement concerné:
   
3. Cliquez sur le menu d'action ⋮ à droite du site concerné dans le tableau qui s'affiche.
4. Cliquez sur Retirer le site:
   

Délier un site d'un hébergement Starter gratuit

Un hébergement Starter (page Web basique) ne contient qu'un seul site qui est propre au nom de domaine lui-même, par conséquent il n'est pas possible comme pour les offres payantes de faire du multisite ni d'enlever un site pour en remettre un autre.

Vous devez donc directement résilier l'hébergement Starter:

• Ceci résiliera votre produit hébergement Web Starter uniquement, c’est-à-dire la partie concernant votre site Web sans impact sur les autres produits, messagerie ou nom de domaine par exemple.
• Vous devrez confirmez la demande de résiliation par mail sinon aucune donnée ne sera supprimée.
• Une confirmation de résiliation est envoyée aux éventuels autres administrateurs de l'Organisation.
• Les sauvegardes seront irrémédiablement supprimées lors de la résiliation, rendant toute restauration impossible.

Afin de résilier:

1. Cliquez ici afin d'accéder à la gestion de votre hébergement sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur le menu d'action ⋮ situé à droite de l'hébergement concerné.
3. Sélectionnez l'option Résilier:
   
4. Suivez la procédure jusqu'au bout.

Ce guide explique comment ajouter des adresses IP à la liste blanche d'un site Web Infomaniak.

Préambule

• Autoriser des IP sur xmlrpc.php permet d'accéder aux URLs qui sont bloquées par défaut, car jugées à risques.
• Ce type de blocage est effectif sur tous les serveurs récents.
• Concernant WordPress, sa fonctionnalité XML-RPC n'est disponible par défaut que via les services Infomaniak et JetPack pour des questions de sécurité.

Ajouter des adresses IP à la liste blanche xmlrpc.php

Pour accéder à la gestion du site Web :

1. Cliquez ici afin d'accéder à la gestion de votre site sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au site concerné:
   
3. Cliquez sur Gérer les paramètres avancés:
   
4. Cliquez sur l'onglet PHP / Apache:
   
5. Complétez la ligne concernée.
6. Cliquez sur le bouton Enregistrer en bas de page:
   

Ce guide présente les Groupes, système de gestion des utilisateurs de votre Organisation, disponible sur le Manager Infomaniak.

Préambule

• Afin de faciliter l'accès et l'ajout d'un collaborateur au sein de l'écosystème Infomaniak, la fonctionnalité Groupes permet de créer des équipes d'utilisateurs et de leur donner en quelques clics accès aux services dont ils auraient besoin.
• Quelques exemples:
  • Vous créez un Groupe pour un nouveau département : associez-lui immédiatement ses boîtes mail, ses dossiers d'organisation kDrive et ses canaux de discussion kChat dédiés ; chaque nouveau collaborateur ajouté à l'équipe recevra automatiquement tous ces accès.
  • Vous êtes une agence Web et vous souhaitez donner l'accès à vos équipes de webmaster à l'ensemble de vos hébergements Web: il vous suffit de créer un nouveau groupe, de choisir l'ensemble des hébergements auxquels ils auront besoin d'accéder et de les inviter à rejoindre le Groupe.
  • Vous possédez un kDrive: autorisez l'accès à un dossier à un Groupe et faites évoluer l'accès en fonction des utilisateurs ajoutés ou retirés de l'équipe au fil du temps.
  • Vous utilisez des services de Streaming ou de Billetterie et vous souhaitez donner l'accès à vos équipes: créez un nouveau Groupe qui aura accès à ces deux produits ou deux Groupes distincts qui auront accès aux deux produits de façon totalement indépendante.
• Il est tout à fait possible:
  • d'associer des ressources (Mail, kDrive, kChat) dès la création du Groupe pour automatiser l'onboarding,
  • d'ajuster les niveaux de droits individuellement : pour kDrive, le droit individuel prévaut sur celui du Groupe, alors que pour Mail, les droits s'additionnent.
  • d'ajouter un même utilisateur à plusieurs Groupes,
  • d'inviter des utilisateurs externes à votre Organisation à l'un de vos Groupes,
  • d'ajouter un ou plusieurs utilisateurs en une fois à un Groupe,
  • de définir un chef d'équipe afin de facilement identifier un responsable de projet ou le référent à contacter.

Gérer vos Groupes

La gestion des Groupes permet désormais une centralisation complète. Plus besoin d'intervenir dans chaque outil séparément : tout se pilote depuis le Manager Infomaniak pour une réorganisation fluide de vos collaborateurs. Prenez connaissance des guides à ce sujet:

• Créer un Groupe
• Modifier un Groupe
• Supprimer un Groupe