Ce guide détaille l'installation de l'app desktop kDrive Infomaniak sur un ordinateur possédant un système d'exploitation Linux. Elle vous permettra ensuite une synchronisation de vos fichiers de l'ordinateur avec kDrive.

Préambule

• Sur cet OS, certaines fonctionnalités de kDrive ne sont pas disponibles, comme l'option Lite Sync ou le menu contextuel au clic droit.
• L'application kDrive est officiellement supportée par Infomaniak uniquement sur les systèmes suivants :
  • Ubuntu 22.04 LTS (et suivantes)
  • Environnements de bureau : GNOME ou KDE
• L'application peut éventuellement fonctionner sur d'autres distributions Linux ou avec d'autres environnements de bureau ; cependant, Infomaniak ne fournit aucun support concernant l'installation ou l'exécution de l'application en dehors des configurations mentionnées ci-dessus.

Installation de kDrive sur Linux

Prérequis

• Télécharger l'app desktop kDrive pour Linux (fichier de type .AppImage)
• Fuse2 (requis pour exécuter une appimage):
  • Depuis la version 23.04 (et suivantes) de Ubuntu, après avoir double-cliqué sur le fichier AppImage, il ne se passera rien.
  • Les dernières versions d'Ubuntu utilisent en effet une version "trop" récente de FUSE (l'interface "Filesystem in User Space" sur laquelle les AppImages s'appuient pour fonctionner) pour laquelle les AppImages ne sont pas conçues.
  • Les AppImages ont besoin de FUSE v2 pour fonctionner: sudo apt install libfuse2
• D-Bus
• Gnome-keyring ou kwallet (en principe déjà présent sur votre machine sauf avec certaines distributions light)

Ensuite:

1. Placez le fichier dans un dossier nommé par exemple "Applications".
2. Faites un clic droit sur le fichier et choisir Permissions.
3. Cochez la case "Autoriser l'exécution du fichier comme un programme".

Afin que kDrive s'exécute au démarrage, ajoutez le fichier dans “Préférences des applications au démarrage” ou similaire.

Problèmes connus et solutions

Synchronisation bloquée ou erreur "Inotify watches"

Si la synchronisation semble figée (ex: étape 1/10) ou si les journaux (logs) indiquent l'erreur Out of memory or limit number of inotify watches reached!, cela signifie que la limite du système pour surveiller les dossiers est atteinte.

• Vérifier la limite actuelle : cat /proc/sys/fs/inotify/max_user_watches
• Augmenter la limite : pour doubler la valeur (ex: passer à 131072), exécutez : 
  echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf 
  Puis appliquez avec : sudo sysctl -p

L'application crash à l'ouverture (AppArmor / Wayland)

Sur certaines versions d'Ubuntu (24.04+) ou Debian, la sécurité AppArmor peut bloquer l'ouverture de la fenêtre de connexion.

• Solution AppArmor : installez les utilitaires : sudo apt install apparmor-utils. Créez ensuite le profil pour kDrive : sudo aa-autodep /chemin/vers/votre/kDrive.AppImage et redémarrez le service : sudo service apparmor restart.
• Conflit Wayland : si l'application crash spécifiquement sous Wayland, tentez de forcer l'utilisation de X11 en lançant l'application via le terminal avec la commande : 
  export QT_QPA_PLATFORM=xcb && ./kDrive.AppImage

Problèmes d'affichage de l'icône ou de la fenêtre

• Icône invisible (Gnome) : installez l'extension AppIndicator Support ; notez que l'extension Dash to Panel est connue pour rendre les menus de l'application invisibles et n'est pas recommandée.
• Fenêtre de synthèse impossible à ouvrir : vérifiez que les bibliothèques libfuse2 et libdbus-1-dev sont bien installées sur votre système.
• KDE Wayland : si l'interface ne s'affiche pas correctement, ajoutez ces lignes à votre fichier ~/.config/kdeglobals :[QtQuickRendererSettings] RenderLoop=basic SceneGraphBackend=opengl

Erreur de stockage des identifiants (Magasin de clés)

Si kDrive demande vos identifiants à chaque démarrage ou indique une erreur Failed to save authentication info to keychain :

• Assurez-vous qu'un gestionnaire de mots de passe (Gnome Keyring ou KWallet) est installé et déverrouillé.
• Vérifiez que le service D-Bus org.freedesktop.secrets est configuré. Si vous utilisez KWallet, le fichier /usr/share/dbus-1/services/org.freedesktop.secrets.service doit contenir :[D-BUS Service] Name=org.freedesktop.secrets Exec=/usr/bin/kwalletd5

Utilisation d'AppImageLauncher

Si vous utilisez AppImageLauncher et que l'intégration échoue, assurez-vous d'utiliser une version supérieure ou égale à la 3.0.0 (beta 2) pour supporter le format de compression du fichier kDrive.

Débogage en cas de crash persistant

Si l'application crash sans message d'erreur, vous pouvez générer un rapport pour analyse en extrayant les dernières lignes du journal système : 
journalctl -r -n 1000 > kdrive_syslog.txt

Ce guide explique comment activer ou désactiver le mode maintenance sur un site Web d'un Hébergement Infomaniak.

Préambule

• Le mode maintenance permet d'afficher un message personnalisé à vos visiteurs par exemple pendant la résolution d'un problème technique.
• Il est également possible de spécifier des adresses IP qui pourront contourner cette page.
• Un e-mail est envoyé aux utilisateurs de l'Organisation.

Activer le mode maintenance

Pour activer une page qui remplace temporairement votre page d'accueil habituelle:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le bouton à bascule (toggle switch) pour activer la page de maintenance.
4. Validez l'avertissement.
5. Cliquez sur le bouton pour activer:
   

Personnaliser la page de maintenance

Pour mettre en place une page avec le message de votre choix:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Page et maintenance dans le menu latéral gauche.
4. Cliquez sur ‍ Créer une page ou sur le bouton Personnaliser si elle existe déjà:
   
5. Mettez en page le texte de votre choix.
6. Configurez l'affichage à l'aide des éléments sur la droite.
7. Cliquez sur Enregistrer & activer pour publier la page:
   

Autoriser des adresses IP

Il est possible d'afficher le site réel même avec le mode maintenance activé. Pour cela, il est nécessaire de renseigner les adresses IP des ordinateurs qui doivent pouvoir contourner le mode maintenance:

1. Activez le mode maintenance selon la procédure ci-dessus.
2. Revenez sur la page de configuration de la page de maintenance (cf procédure ci-dessus).
3. Sous Maintenance à droite, cliquez sur Insérer mon adresse IP pour autoriser votre ordinateur à afficher le site sans mode maintenance:
   
   • Il est également possible de saisir manuellement les IP à autoriser.
4. Cliquez sur Enregistrer et publier.

Désactiver le mode maintenance

Pour désactiver le message qui s'affiche sur votre site pendant la maintenance:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez soit sur le bouton Désactiver ou sur le bouton à bascule (toggle switch) pour désactiver la page de maintenance:
   
4. Confirmez la désactivation de la maintenance.

Méthode alternative pour WordPress

Il n'est pas recommandé d'activer la page de maintenance Infomaniak ci-dessus pour travailler ensuite dans WordPress.

Il est recommandé d'installer une extension WordPress (il en existe des dizaines) dédiée à la mise en maintenance au sein du CMS lui-même.

Vous pouvez sinon ajouter le code <?php $upgrading = time(); ?> dans un nouveau fichier vide nommé .maintenance (le point avant le nom du fichier est important) placé sur le serveur à la racine de votre site, ce qui désactivera toutes vos pages sauf la page d'accueil de WordPress.

Ce guide concerne l'optimisation de site Web et plus particulièrement l'utilisation sur celui-ci d'un moteur de cache.

Préambule

• Lorsque Infomaniak constate que votre site Web consomme plus de ressources que les autres sites sur le même serveur, une analyse est réalisée.
  • Bien souvent, il apparaît qu'une simple modification d'une requête ou d'un paramètre permettrait d'optimiser votre site et d'alléger la charge serveur.
  • Vous serez alors contacté par mail avec les instructions à suivre, qui incluent fréquemment l'installation ou l'activation d'un moteur de cache.
• La consommation de ressources n'est pas forcément liée au nombre de visiteurs.
  • Un site bien optimisé, à jour et avec un moteur de cache correctement configuré peut gérer plusieurs dizaines de milliers de visiteurs quotidiens, tandis qu'un site mal optimisé peut consommer beaucoup trop de ressources avec seulement quelques visites par jour.
• Un moteur de cache stocke temporairement des données fréquemment utilisées afin de les fournir plus rapidement lors de nouvelles requêtes.
  • Cela améliore significativement la rapidité du site et réduit la charge sur les bases de données ou services Web.
  • Pour installer un système de cache avancé (Redis, Memcached) sur Serveur Cloud Infomaniak, prenez connaissance de ce guide.

Activer un moteur de cache…

… sur WordPress

WordPress dispose de nombreux plugins de cache. Voici les plus populaires et efficaces :

• WP Rocket (payant, solution "tout-en-un" la plus performante et simple).
• WP Super Cache (gratuit, développé par Automattic, très fiable).
• LiteSpeed Cache (gratuit, extrêmement complet).

Procédure d'activation standard :

1. Connectez-vous à votre administration WordPress.
2. Allez dans Extensions > Ajouter.
3. Recherchez l'un des plugins cités, installez-le puis activez-le.
4. Configurez les options de cache : mise en cache des pages, minification CSS/JS, et surtout le Lazy Load pour les images.

Prenez également connaissance de cet autre guide à ce sujet.

… sur Joomla (v4 & v5)

1. Accédez à Système > Configuration globale.
2. Sélectionnez l’onglet Système.
3. Dans la section Paramètres du cache, activez le cache (le mode Conservateur est le plus sûr pour débuter).
4. Sélectionnez le gestionnaire de cache (Fichier par défaut).
5. Allez ensuite dans Système > Plugins et assurez-vous que le plugin Système - Cache est activé pour mettre en cache les pages entières.

… sur PrestaShop (v1.7 & v8+)

1. Allez dans Paramètres avancés > Performances.
2. Smarty : cochez "Ne jamais recompiler les fichiers de templates" (en production) et activez le "Cache".
3. CCC (Combine, Compress and Cache) : activez toutes les options (Smart cache CSS, Smart cache JS, Optimisation Apache).
4. Cache : en bas de page, activez "Utiliser le cache". Sur un hébergement mutualisé, privilégiez le système de fichiers ; sur Serveur Cloud, utilisez Memcached.

… sur Drupal (v9, v10 & v11)

Le cache est nativement intégré et très puissant sur Drupal :

1. Allez dans Configuration > Développement > Performance.
2. Cochez "Mettre en cache les pages pour les utilisateurs anonymes".
3. Définissez une durée pour "Expiration maximale du cache dans le navigateur et le proxy" (ex: 10 minutes).
4. Activez l'agrégation des fichiers CSS et JavaScript.

… sur Contao (v4 & v5)

1. Le cache se gère désormais principalement via le fichier de configuration config/config.yaml ou via l'interface d'administration sous Mise en page > Thèmes > Éditer la mise en page de la page.
2. Définissez un "Délai d'expiration du cache" pour la page concernée.
3. Utilisez le Contao Manager pour vider le cache de production (Symfony Cache) après des modifications structurelles.

Vérifier l'efficacité

Après activation, testez votre site avec ces outils gratuits :

• Google PageSpeed Insights
• GTmetrix

Ce guide détaille comment, lors de l'activation d'un nouveau thème WordPress, la mise en forme et le contenu des articles et pages peuvent être altérés, ceci si le nouveau thème n'utilise pas les mêmes shortcodes et/ou le même page builder (constructeur de pages).

Problèmes de mise en page

Voici par exemple comment peuvent apparaître vos articles et pages après avoir changé de thème WordPress:

Il n'existe malheureusement pas de solution automatique pour corriger ce problème: vous devrez:

• soit revenir à l'ancien thème que vous utilisiez
• soit manuellement adapter le contenu de votre site avec les outils prévus par votre nouveau thème WordPress.

Évidemment, vous pouvez également désinstaller et réinstaller WordPress, le contenu du site sera effacé et vous repartirez sur de bonnes bases.

Réduire les problèmes à l'avenir

Voici quelques conseils qui vous éviteront de devoir remettre en forme tout le contenu de votre site en cas de changement de thème:

• Utilisez le moins possible les shortcodes propres à votre thème WordPress.
• Utilisez un page builder universel qui est compatible avec tous les thèmes WordPress (par exemple Visual Composer ou Thrive Content Builder).
• Prenez le temps de tester et évaluer la qualité d'un thème, en comparant avec 2-3 autres thèmes similaires, avant de l'utiliser et d'adapter tout le contenu de votre site.

Ressources utiles

• Trouver et supprimer automatiquement tous les shortcodes inutilisés (article en anglais)…

Ce guide concerne Django, un framework open-source de développement Web en Python.

Installation de Django

Il est possible d'installer Django sur des offres Web telles que les VPS Cloud / VPS Lite: découvrir les différents hébergements Web d'Infomaniak.

Ce guide explique comment utiliser GnuPG / PGP avec PHP sur un Serveur Cloud Infomaniak, suite à l'obsolescence de l'extension native (des alternatives "PHP pur" ou des wrappers modernes sont privilégiés).

Préambule

• L'extension système PHP_GnuPG n'est plus maintenue par la communauté PHP et n'est donc plus disponible sur les environnements récents.
• Deux alternatives principales en "Pure PHP" (installables via Composer) permettent de continuer à signer ou chiffrer vos données en toute sécurité.
• En cas de besoin, des partenaires locaux et référencés par Infomaniak peuvent s'occuper de ces démarches : lancez un appel d'offres gratuit ; ils s'occupent de tout, vous libérant des détails techniques — découvrez aussi le rôle de l'hébergeur.

Option 1 : Crypt_GPG (Recommandé)

Cette bibliothèque agit comme un wrapper : elle communique directement avec le binaire gpg installé sur votre Serveur Cloud. C'est la solution la plus performante et la plus stable.

Pour l'installer, connectez-vous en SSH et exécutez cette commande à la racine de votre projet :

# Install the PEAR Crypt_GPG package via Composer
composer require pear/crypt_gpg

Exemple d'utilisation pour chiffrer un message (approche orientée objet) :

<?php
require_once 'vendor/autoload.php';

try {
    // Initialize the GPG object
    $gpg = new Crypt_GPG();

    // Set the recipient email (must match a public key already imported on the server)
    $gpg->addEncryptKey('contact@example.com');

    $message = "This is a secret message.";
    
    // Encrypt the data
    $enveloppe = $gpg->encrypt($message);
    
    echo $enveloppe;
} catch (Exception $e) {
    // Handle potential encryption errors
    echo "Error: " . $e->getMessage();
}

Option 2 : OpenPGP.php (Indépendant)

Cette bibliothèque est intégralement écrite en PHP. Son avantage majeur est qu'elle ne dépend pas du binaire gpg du serveur, garantissant une portabilité totale de votre code entre différents environnements.

# Install the OpenPGP.php library
composer require singpolyma/openpgp-php

Exemple de structure de base :

<?php
require_once 'vendor/autoload.php';

// Use the library classes to handle OpenPGP packets 
// directly in PHP without system calls to the GPG binary.
// Example: $msg = OpenPGP_Message::parse(OpenPGP::unarmor($data));

Ce guide détaille les spécificités liées à la gestion de MongoDB sur votre Serveur Cloud managé, notamment concernant le cycle de vie des versions.

Préambule

• Toute nouvelle installation de l'application déploie MongoDB version 7.0 (ou supérieure) par défaut.

Passer de la version 6 à 7

Il n'est pas possible d'effectuer une mise à jour (upgrade) automatique de la version 6 vers la version 7 directement depuis votre interface.

Deux solutions s'offrent à vous :

1. Commander un nouveau Serveur Cloud : il disposera nativement de la version 7, vous pourrez ensuite y migrer vos données.
2. Réinstaller l'application : désinstaller puis réinstaller MongoDB sur le serveur actuel.

Sauvegardes et responsabilité

En tant qu'administrateur, la gestion et l'intégrité de vos données vous incombent entièrement.

Avant toute manipulation (notamment la réinstallation) :

• Effectuez vos propres sauvegardes et exports (dump) de vos bases de données.
• Prévoyez l'import manuel de vos données une fois la nouvelle version active.

Supervisor n'est pas proposé directement car systemd est recommandé, mieux intégré à Debian et disponible dans Fast installer.

Si vous deviez l'installer malgré tout, contactez le support Infomaniak par écrit.

Ce guide concerne Laravel, un framework Web open-source écrit en PHP respectant le principe modèle-vue-contrôleur (MVC). Prenez également connaissance de leur documentation.

Prérequis

• Posséder un Hébergement Web mutualisé ou Serveur Cloud avec MySQL/MariaDB le plus récent.
• Site sous PHP 8.2.
• Créer un accès SSH.
• Créer une base de données.

Installation de Laravel 11

Pour cela:

1. Connectez-vous sur le serveur en SSH (besoin d'aide ?).
2. Placez-vous dans le répertoire du site en exécutant la commande “cd chemin-vers-le-site” (par exemple cd sites/laravel.domain.xyz).
3. Créez un nouveau projet en exécutant la commande composer create-project laravel/laravel example-app.
4. Modifiez le fichier .env à la racine de l’hébergement pour mettre à jour les paramètres de connexion à la nouvelle base de données:
   • DB_CONNECTION=mysql
   • DB_HOST=xxxx.myd.infomaniak.com
   • DB_PORT=3306
   • DB_DATABASE= le nom de la base de données MySQL (xxxx_newbdd)
   • DB_USERNAME= l’utilisateur MySQL avec les droits sur cette base
   • DB_PASSWORD= son mot de passe
5. Placez-vous dans le répertoire du projet et publier via SSH:
   cd example-app
php artisan migrate
6. Modifiez le répertoire cible pour le faire pointer dans le sous-répertoire «public» du projet, ici /sites/laravel.domain.xyz/example-app/public.

Ce guide explique comment installer ownCloud (ou Nextcloud qui est une version améliorée de Owncloud) en quelques clics sur les offres d'Hébergement Web payantes.

Préambule

• OwnCloud fait partie des applications (non développées par Infomaniak) et permet la mise en place d'un système de stockage & partage de fichiers au sein d'un "cloud" que vous maîtrisez entièrement (gestion des utilisateurs, permissions, quotas, applications mobiles associées, etc.).
• Contrairement à d'autres hébergeurs, Infomaniak autorise l'utilisation d'ownCloud sur ses hébergements:
  • Une utilisation personnelle est autorisée sur les hébergements Web mutualisé.
  • Pour un usage intensif et professionnel, il est recommandé d'opter pour un Serveur Cloud afin d'y installer ownCloud ou Nextcloud.

Installer ownCloud

Prérequis

• Posséder un hébergement Web Infomaniak (commander si nécessaire).
• Mettre à niveau la partie Bases de données si nécessaire (surtout pour Nextcloud).
• Si un site vierge est déjà présent sur l'hébergement, cliquez sur le bouton comme sur l'image ci-dessous et sautez directement à l'étape 8:
   

Afin d'accéder à l'Hébergement Web et d'y installer un nouveau site avec l'application:

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 sur lequel installer l'application.
3. Cliquez sur le bouton Ajouter un site:
   
4. Sélectionnez l'option intermédiare pour le déploiement d'outils.
5. Cliquez sur Suivant:
   
6. Sélectionnez le domaine ou sous-domaine et les options avancées si nécessaire, puis cliquez sur Suivant:
   
7. Patientez quelques minutes, le temps de la création du site:
   
8. Sélectionnez l'application souhaitée (si nécessaire, filtrez et recherchez):
   
9. Cliquez sur Suivant en bas de page:
   
10. Laissez l'emplacement par défaut ou choisissez d'installer l'app dans un nouveau dossier que vous pouvez créer grâce à une icône visible à droite du point 10 sur l'image.
11. Choisissez éventuellement d'installer une version antérieure si nécessaire.
12. Cliquez sur Suivant:
    
13. Configurez nom d'utilisateur et mot de passe.
14. Spécifiez certains réglages avancés si nécessaire (type de sauvegarde notamment).
15. Prenez connaissance et acceptez les conditions d'utilisation de l'app sélectionnée.
16. Cliquez sur Suivant:
    
17. Confirmez l'installation de l'application à l'étape suivante et patientez:
    
    • Prenez connaissance d'éventuel message d'erreur à l'écran si par exemple le dossier d'installation choisi n'est pas vide ou si la version de PHP du site sur lequel vous tentez l'installation n'est pas compatible.

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 dans le Manager Infomaniak 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 produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Gérer sous 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. 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 :

   # 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 une mise à jour standard (dernière version) :

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

   Pour une version spécifique (ex: v5) :

   # 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. Redémarrez votre hébergement sur le Manager Infomaniak 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 vous accompagne dans l’installation sur Infomaniak de n8n, une solution d'automatisation de flux de travail (workflow) puissante et extensible.

Préambule

• Contrairement à des outils comme Zapier ou Make, n8n, outil d'automatisation de workflow “fair-code”, peut être auto-hébergé, ce qui vous permet de garder un contrôle total sur vos données tout en connectant des centaines de services via une interface visuelle intuitive.
• En cas de besoin, des partenaires locaux et référencés par Infomaniak peuvent s'occuper de ces démarches : lancez un appel d'offres gratuit ; ils s'occupent de tout, vous libérant des détails techniques — découvrez aussi le rôle de l'hébergeur.

Installation de n8n

Prérequis

• Avoir installé un site vierge de type Node.js sur un hébergement Web ou Serveur Cloud Infomaniak.
• Arrêter votre application Node.js avant de procéder à l'installation !

Pour configurer votre hébergement (via le Manager Infomaniak):

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Stoppez si nécessaire l'application, puis cliquez sur Gérer sous Paramètres avancés:
   
4. Cliquez sur l'onglet Node.js pour accéder aux réglages.
5. Sélectionnez une version récente (par exemple 24 ou supérieure).

6. Entrez la commande suivante en remplaçant https://domaine.xyz par l'adresse réelle de votre site:

   N8N_RELEASE_TYPE="stable" NODE_ENV="production" N8N_EDITOR_BASE_URL="https://domaine.xyz" WEBHOOK_URL="https://domaine.xyz" GENERIC_TIMEZONE="Europe/Zurich" /srv/customer/node_modules/.bin/n8n start

7. Indiquez 5678 pour le port d'écoute.
8. Activez la case "Définir la commande de construction".

9. Entrez la commande suivante:

   cd && npm install n8n@latest sqlite3

10. Cliquez sur Enregistrer:
    
11. Lancez l'étape du Build en cliquant sur le bouton Lancer sous Construction de l'application:
    
12. Sur la page principale, cliquez sur le bouton Démarrer (ou Redémarrer):
    
13. Patientez quelques minutes, puis rendez-vous sur l'URL de votre site (ex: https://domain.xyz).
14. Lors de votre première connexion, n8n vous demandera de créer un compte propriétaire pour sécuriser votre instance.

Votre instance n8n est désormais opérationnelle ! Vous pouvez commencer à créer vos automatisations.

Si vous rencontrez une erreur indiquant que le port est déjà utilisé lors du démarrage :

1. Changez temporairement la Version de Node.js dans les réglages (ex: passez de la v24 à la v23) et enregistrez. Cela force l'arrêt complet des processus.
2. Remettez la version souhaitée (v24) et enregistrez à nouveau.
3. Relancez l'application.

Mettre à jour n8n

Il est recommandé de maintenir régulièrement votre instance n8n à jour pour bénéficier des dernières fonctionnalités et correctifs de sécurité. Deux méthodes s'offrent à vous:

Méthode 1 : via le Manager Infomaniak (Recommandé)

Pour mettre à jour n8n, il suffit de relancer le processus de construction de l'application :

• Vérifiez au préalable dans les Paramètres avancés que votre commande de construction utilise bien la balise @latest :

  cd && npm install n8n@latest sqlite3

• Cliquez sur le bouton Lancer sous la section Construction de l'application.
• Important : ne supprimez pas le dossier node_modules ; le système se chargera de mettre à jour les paquets existants vers leur version la plus récente:
  

Méthode 2 : via une connexion SSH

Si vous préférez utiliser la ligne de commande, vous pouvez mettre à jour n8n directement depuis l'environnement Node.js:

1. Connectez-vous à votre serveur en SSH.

2. Accédez au répertoire de l'application et lancez la mise à jour :

   cd /srv/customer
   npm update n8n

3. Une fois l'opération terminée, redémarrez l'application depuis le Manager Infomaniak pour appliquer les changements.

Ce guide vous explique comment mettre en place et utiliser votre pack de vente avec l'imprimante Zebra pour les billets de format spectacle et cinéma (dans le cadre du système de billetterie Infomaniak).

Guide Vidéo

Alimentation et connexion de la borne au réseau

Raccorder la borne

Pour connecter la borne à votre réseau, il vous faudra le brancher au moyen du raccordement Ethernet :

1. Branchez la borne (MAIN/48V) à l’adaptateur sur l’emplacement POE:
   
      
    
2. Branchez l’adaptateur au réseau internet sur l’emplacement LAN:
   
   

Allumer la borne

La borne va s’allumer et le voyant lumineux deviendra bleue, indiquant le bon fonctionnement de la borne:

Se connecter au réseau Infomaniak

Une fois la borne allumée et connectée au réseau par Ethernet, la borne va créer un réseau intitulé "Infomaniak".

En savoir plus

• Guide démarrage : Billetterie
• Mise en place du pack de vente
• Installation et utilisation du pack de vente

Ce guide vous explique comment mettre en place et utiliser la borne 4G pour pouvoir connecter votre pack de vente ou scanners lié au système de billetterie Infomaniak.

Préambule

• La borne 4G fonctionne comme un point d'accès pour vos machines de ventes sur place et scanners.
• Elle se connecte sur un réseau de téléphonie mobile et crée un réseau sur lequel les tablettes, imprimantes et scanners vont se connecter.
• Il n'y a nul besoin d'utiliser le branchement ethernet RJ45 pour utiliser la borne 4G.

Mettre en place la borne 4G

Prérequis

• Posséder une couverture de réseau mobile suffisante pour que la borne 4G puisse fonctionner.

Prenez connaissance du guide vidéo:

Faire fonctionner la borne

1. Appuyez sur le bouton sur le haut de la machine pendant environ 4 secondes:
   
2. L’écran va s’allumer:
   
3. La borne se connecte automatique au réseau Swisscom et est prête à l'utilisation:
   
   • Il est possible de vérifier le nombre d'appareils connectés à la borne avec une simple pression du bouton.
   • Le nombre de jours restants est un décompte à la fin du mois et n'a aucune conséquence au niveau de l'utilisation de la borne…
4. Une fois la borne allumée et connectée au réseau 4G, la borne va créer un réseau intitulé Infomaniak.
   • Les imprimantes, tablettes et scanners Infomaniak se connecteront automatiquement à ce réseau.

Ce guide détaille le système Kubernetes de Public Cloud qu'il est possible de commander et d'installer directement sur votre Manager:

Interfaces et tarification du Service Kubernetes d'Infomaniak

Infomaniak propose une solution Kubernetes complète avec plusieurs interfaces de gestion et une tarification flexible adaptée à vos besoins.

Interfaces disponibles

Le service Kubernetes d'Infomaniak vous offre plusieurs méthodes d'accès et de gestion :

• API Kubernetes native : Interagissez directement avec votre cluster via l'API Kubernetes standard
• Fichier kubeconfig : Configurez facilement vos outils de ligne de commande comme kubectl
• Terraform/OpenTofu : Gérez votre infrastructure sous forme de code (IaC)
• Kubernetes Manager : Interface web intuitive pour piloter vos clusters
• CLI d'Infomaniak : Automatisez vos opérations via ligne de commande

Structure tarifaire

Le service Kubernetes d'Infomaniak propose plusieurs offres qui correspondent au prix du control plane. Il est important de noter que les ressources incluant réseau, instances, … ne sont pas incluses dans ce tarif de base. 

Les instances nécessaires au fonctionnement de vos applications sont facturées aux tarifs standards du Public Cloud d'Infomaniak. Vous profitez automatiquement des avantages tarifaires d’Infomaniak, y compris le trafic inclus et les instances à bas coût, disponibles sur la page Tarifs.

• Instances (VMs) : à partir d'un montant facturé par heure selon la configuration choisie
• Stockage Block : à partir d'un montant facturé par Go par mois
• Snapshot : à partir d'un montant facturé par Go par mois

Cette structure vous permet de ne payer que pour les ressources que vous utilisez réellement, tout en bénéficiant d'un control plane Kubernetes entièrement géré par Infomaniak.

Ce guide concerne le module WordPress "Infomaniak Connect for OpenID" qui permet aux utilisateurs de se connecter à votre site WordPress (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 WordPress 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 WordPress 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 WordPress

Pour cela:

1. Recherchez l'extension Infomaniak Connect for OpenID sur la plateforme d'extensions WordPress depuis votre site.
2. Installez et activez l'extension:
   
3. Configurez l'extension depuis le menu Paramètres:
   
4. Les seuls champs à remplir sont Client ID et Client Secret Key et proviennent des informations obtenues au point A ci-dessus:
   
5. N'oubliez pas d'enregistrer les modifications apportées aux réglages de l'extension.
6. Un bouton supplémentaire, pour une connexion par identifiant Infomaniak, est désormais visible sur votre page de connexion destinée aux utilisateurs /wp-admin (/wp-login.php):
   

Ce guide explique comment obtenir un certificat SSL personnalisé que vous pourrez utiliser avec Jelastic Cloud auprès d'Infomaniak.

Documentation pour le SSL

Prenez connaissance de ces guides:

• Il est tout à fait possible d'acheter un certificat SSL auprès d'Infomaniak afin de l'installer sur Jelastic Cloud ensuite.
• De façon intégrée à Jelastic Cloud, vous trouverez également un certificat valable que pour des domaines xxx.jcloud.ik-server.com.
• Les certificats Let's Encrypt peuvent également être obtenus gratuitement et pour n'importe quel domaine.
• Il est possible d'obtenir un certificat payant, pour n'importe quel domaine.
• Dans le but de procéder à des tests, vous pouvez également mettre en place un certificat auto-signé.
   

Ce guide explique comment connaître la version du système d'exploitation du serveur de votre Hébergement Web.

Préambule

• Même si Debian ou un paquet semble obsolète, les versions affichées ne présentent pas de vulnérabilités :
  • Infomaniak les maintient à jour via des correctifs internes réguliers sur tous les composants et systèmes utilisés.
  • Les versions sont choisies pour leur stabilité, puis renforcées par des mesures de sécurité que les tests classiques ne détectent pas.
• Si vous ou vos clients identifiez une faille dans un produit Infomaniak, merci de soumettre un POC. Bien que rares, ces cas sont pris en charge rapidement.
  • La sécurité des données relève de l'utilisateur : Infomaniak ne peut être tenu responsable d’une mauvaise gestion ou utilisation des identifiants d’accès.

Quel OS sur mon site ?

Pour connaitre la version:

1. Connectez-vous sur le serveur en SSH (besoin d'aide ?).

2. Exécutez la commande suivante:

   lsb_release -a

3. Vous obtiendrez une information de ce type:

   Distributor ID: Debian
   Description: Debian GNU/Linux 7.9 (wheezy)
   Release: 7.9
   Codename: wheezy

Aujourd'hui, Magento (désormais Adobe Commerce ou Magento Open Source) est une plateforme moderne qui exige un environnement serveur respectant ses prérequis stricts. La version stable actuelle est souvent la 2.4.8 ou une version de correctif plus récente. Ces versions nécessitent impérativement des technologies à jour comme PHP 8.2/8.3, MySQL 8.0/MariaDB 10.6 et un moteur de recherche dédié comme Elasticsearch ou OpenSearch.

Pour toute nouvelle installation ou migration, il est fortement recommandé d'utiliser la dernière version stable sans aucune modification manuelle du code source. Vous devez choisir un type d'hébergement performant (Serveur Cloud ou VPS/Dédié) qui garantit l'accès à tous les privilèges système requis pour un fonctionnement sécurisé et stable.

Ce guide explique comment patcher l'installation de Magento afin que celle-ci puisse être réalisée sur un hébergement mutualisé Infomaniak, même sans les privilèges de type triggers & routines.

Résoudre les problèmes d'installation de Magento 2

Editez le fichier DbValidator.php:

--- setup/src/Magento/Setup/Validator/DbValidator.php.orig 2019-04-11 17:01:45.154767893 +0200
+++ setup/src/Magento/Setup/Validator/DbValidator.php 2019-04-13 21:37:02.560386985 +0200
@@ -150,12 +150,8 @@
'ALTER',
'CREATE TEMPORARY TABLES',
'LOCK TABLES',
- 'EXECUTE',
'CREATE VIEW',
- 'SHOW VIEW',
- 'CREATE ROUTINE',
- 'ALTER ROUTINE',
- 'TRIGGER'
+ 'SHOW VIEW'
];
// check global privileges

En cas d'erreur SOAP/PHPfpm

Selon la version de Magento utilisée, la fonction soap ne fonctionne pas correctement et peut renvoyer le message d'erreur suivant: «Uncaught SoapFault exception: [Client] looks like we got no XML document».

Le problème ne vient pas d'une mauvaise configuration du serveur, mais plutôt d'un mauvais design de Magento qui ne prend pas en compte le cas d'exécution de PHP en environnement FPM. Ainsi, les requêtes SOAP générées par Magento comportent des doubles headers (non conforme à la spécification SOAP) et génèrent une erreur.

Prenez connaissance de cette solution (non développée par Infomaniak).