Base de connaissances

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é.

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.

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

Préambule

• La borne Wi-Fi fonctionne comme un point d'accès réseau pour vos machines de vente sur place (tablettes, imprimantes) et vos scanners.
• Contrairement à la borne 4G, elle nécessite une connexion à votre réseau filaire (Ethernet) disposant d'un accès à Internet.
• Elle est alimentée et reliée au réseau au moyen d'un adaptateur PoE (Power over Ethernet).

Mettre en place la borne Wi-Fi

Prérequis

• Disposer d'un port Ethernet (RJ45) mural ou d'un routeur avec une connexion Internet fonctionnelle.
• Disposer d'une prise électrique secteur à proximité.

Faire fonctionner la borne

Pour cela :

1. Branchez un câble Ethernet (RJ45) sous la borne Wi-Fi :
   
2. Branchez l'autre extrémité de ce câble sur le port POE de l'adaptateur :
   
3. Branchez le deuxième câble Ethernet sur le port LAN de l'adaptateur, puis reliez-le à votre port Ethernet réseau relié à Internet :
   
4. Branchez le câble d'alimentation à l'adaptateur, puis reliez-le à une prise électrique secteur.
5. Patientez jusqu'à ce que la lumière de la borne Wi-Fi devienne bleue :
   
6. Une fois la borne allumée et connectée au réseau, elle va créer un réseau intitulé Infomaniak.
   • Les imprimantes, tablettes et scanners Infomaniak se connecteront automatiquement à ce réseau.

En savoir plus

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

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 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.

Installation de n8n

Prérequis

• Un site de type Node.js (v22 recommandé).
• Arrêter l'application Node.js depuis le dashboard de votre site Node.js avant toute opération technique.

Pour configurer votre site (via le Manager Infomaniak):

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du site Node.js concerné.
3. Stoppez si nécessaire l'application, puis cliquez sur Gérer les 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 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 (❓: aide).

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 du service Auth sur votre Manager Infomaniak (❓: 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 (❓: aide).
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 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 des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du site Node.js 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 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 vous explique comment mettre en place et utiliser la borne 4G pour pouvoir connecter votre pack de vente ou vos scanners liés au système de billetterie Infomaniak.

Préambule

• La borne 4G fonctionne comme un point d'accès pour vos machines de vente sur place et vos scanners.
• Elle se connecte à un réseau de téléphonie mobile et crée un réseau auquel les tablettes, imprimantes et scanners vont se connecter.
• Il n'est pas nécessaire 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.

Faire fonctionner la borne

Pour cela :

1. Appuyez sur le bouton situé sur le haut de la machine pendant environ 4 secondes :
   
2. L'écran va s'allumer :
   
3. La borne se connecte automatiquement 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 jusqu'à la fin du mois et n'a aucune conséquence sur l'utilisation de la borne.
4. Une fois la borne allumée et connectée au réseau 4G, elle va créer un réseau intitulé Infomaniak.
   • Les imprimantes, tablettes et scanners Infomaniak se connecteront automatiquement à ce réseau.

Sur Jelastic Cloud, les applications peuvent y être déployées en utilisant un fichier local (zip, war, ear) ou via GIT, SVN avec des mises à jour automatiques.

Jelastic permet également d'utiliser d'autres outils de déploiement via les extensions suivantes : Maven, Jenkins, Ant, Eclipse, NetBeans, IntelliJ IDEA.

En savoir plus

• Documentation officielle
• Guide de démarrage de Jelastic Cloud

Ce guide explique comment effectuer un transfert de site sur lequel est installé WordPress, à l'aide d'une de ses extensions, All-in-One WP Migration.

Prérequis

• Commander un hébergement Web / Serveur Cloud si vous n'en avez pas encore (❓: aide).
• Créer un site (❓: aide) sur votre nouvel hébergement en choisissant d'y installer WordPress Infomaniak (choix proposé lors de l'ajout d'un site - vous pouvez également installer un site WordPress (❓: aide) après création d'un site vierge).

Sauvegarde complète du site WordPress

Pour sauvegarder tous les fichiers et la base de données d'un site WordPress existant:

1. Installez puis activez l'extension All-in-One WP Migration depuis l'interface d'administration WordPress du site actuel.
2. Rendez-vous sur le tableau de bord de l'extension fraichement installée.
3. Cliquez sur Exporter.
4. Téléchargez l'archive exportée:
   
   

Restauration du site

Comme spécifié dans le prérequis ci-dessus, installez un nouveau WordPress sur votre hébergement Web Infomaniak puis:

1. Installez et activez l'extension All-in-One WP Migration depuis l'interface d'administration du nouveau WordPress (il est parfois nécessaire d'utiliser l'URL de prévisualisation pour se connecter au nouveau site, par exemple si le domaine est en cours de transfert).
2. Rendez-vous sur le tableau de bord de l'extension fraichement installée.
3. Cliquez pour importer un fichier, en l'occurrence ici l'archive exportée de votre précédent site WordPress.
   • Si l'archive est volumineuse il faut augmenter, dans les paramètres du site (❓: aide), la valeur de la taille maximum autorisée pour les importations sur le serveur.
4. Une fois le site réimporté, reconfigurez l'adresse principale du site côté Infomaniak.
5. Lorsque les conditions le permettent (par exemple transfert du nom de domaine terminé), installez un certificat SSL et vérifiez à nouveau le point 4 ci-dessus pour y sélectionner l'adresse httpS://.

Ce guide explique comment préparer votre serveur et installer l'Agent de sauvegarde Acronis pour Swiss Backup sur AlmaLinux 9.

Installer l'agent Acronis CyberProtect

1. Prérequis système

• Utilisez un compte avec privilèges root.
• Accès internet requis pour les dépôts et le téléchargement.
• Espace disque disponible : environ 2 Go.

2. Préparation du système

1. Passez en utilisateur root :

   # Switch to root user
   sudo -i

2. Mettez à jour le cache des métadonnées DNF :

   # Refresh DNF metadata cache
   dnf -y makecache

3. Vérifiez les versions actuelles du noyau et de GCC :

   # Check current kernel and GCC version
   cat /proc/version

   Si la version du noyau ne correspond pas au paquet kernel-devel disponible, une mise à jour sera nécessaire à l'étape suivante.

4. Installez l'outil de construction (make) :

   # Install make utility
   dnf install -y make
   # Verify installation
   make -v | head -n 1

5. Installez le compilateur GCC :

   # Install GCC compiler
   dnf install -y gcc
   # Verify version (should match the one in /proc/version)
   gcc -dumpfullversion

6. Installez le dernier noyau et ses en-têtes (kernel-devel) :

   # List available versions
   dnf list kernel kernel-devel --showduplicates | sort -r
   # Install latest kernel and headers
   dnf install -y kernel kernel-devel

7. Redémarrez le serveur pour charger le nouveau noyau :

   # Reboot the system
   systemctl reboot

   Après le redémarrage, reconnectez-vous et repassez en root (sudo -i).

8. Confirmez la présence de tous les outils requis :

   # Final environment check
   uname -r
   rpm -qa | grep ^kernel-devel
   make -v | head -n 1
   gcc -dumpfullversion
   perl -v | head -n 2

3. Téléchargement de l'installeur

1. Installez wget si nécessaire :

   # Install wget
   dnf install -y wget

2. Obtenez l'URL de téléchargement :
   • Connectez-vous sur https://acronis.infomaniak.com.
   • Allez dans Terminaux → Tous les terminaux.
   • Cliquez sur Ajouter et sélectionnez Linux.
   • Copiez l'URL complète contenant votre jeton (token).

3. Téléchargez le binaire sur votre serveur :

   # Download the installer using your URL
   wget -O CyberProtect_AgentForLinux_x86_64.bin "metre_ici_URL_obtenue_avant"

4. Rendez le fichier exécutable :

   # Set execution permissions
   chmod +x CyberProtect_AgentForLinux_x86_64.bin

4. Installation de l'agent

1. Lancez l'installation :

   # Run the installation script
   ./CyberProtect_AgentForLinux_x86_64.bin

2. Utilisez la touche Tab pour naviguer et Entrée pour valider dans l'interface textuelle.
3. Sélectionnez Installer. 
   
4. Acceptez l'installation automatique des dépendances manquantes via YUM. 
   
5. En fin de processus, choisissez Afficher les informations d'enregistrement. 
   
6. Notez précieusement le Code d'enregistrement affiché (ex: ABCD-1234). 
   

5. Enregistrement sur la console Acronis

1. Retournez sur votre console Acronis (navigateur).
2. Cliquez sur Ajouter, puis tout en bas de la liste, choisissez Enregistrement par code. 
   
3. Saisissez le code obtenu sur le serveur et cliquez sur Valider. 
   
4. Important : Sur l'écran de sélection du plan, cliquez sur le menu déroulant
   
5. et choisissez Ne pas appliquer. 
   
6. Cliquez sur Suivant
   
7. puis sur Enregistrer. 
   
8. Vérifiez que votre serveur apparaît bien dans la liste des terminaux après quelques secondes. 
   

6. Création du plan de protection

1. Cliquez sur le nom de votre serveur dans la liste, puis sur le bouton Protéger.
2. Choisissez Création d'un plan → Protection. 
   
3. Définissez vos paramètres de sauvegarde (fréquence, rétention, destination).
4. Attention : Si vous activez le chiffrement, conservez le mot de passe en lieu sûr. Sans lui, vos sauvegardes seront inutilisables.
5. Vérifiez la configuration et cliquez sur Créer.

Ce guide explique comment déployer Node.js avec un Serveur Cloud afin de disposer en permanence de l'environnement nécessaire pour compiler ou builder des frontends modernes (React, Vue, etc.). Il est toutefois recommandé d'utiliser la solution node.js “intégrée”.

Préambule

• Node.js est une plateforme logicielle libre en JavaScript orientée vers les applications réseau qui doivent pouvoir monter en charge, une solution simple et efficace pour intégrer les outils frontend dans n'importe quel stack serveur.
  • 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).

Installer Node.js

Prérequis

• Installer NVM sur votre Serveur Cloud.
• Attention la version 18 de Node.js n'est pas compatible avec les anciens Serveurs Cloud ; effectuer une migration au préalable!

Installer la version stable de Node.js

nvm install stable

Installer la dernière version en date

nvm install node

Installer une version antérieure (non recommandé)

nvm install 17

Lister les versions disponibles

nvm ls-remote

Installer une version spécifique

nvm install <version>

Changer de version de Node.js et définir la version 6.3.1 (ou une autre version) par défaut

nvm alias default 6.3.1

Utiliser une version spécifique de Node.js dans le shell actuel

nvm use <version>

Vérifier la version de Node.js actuellement utilisée

node -v

Source

Pour mettre en place NVM, rendez-vous sur la console WebSSH de votre Serveur Cloud.

Sourcer le fichier .profile

source ~/.profile

Exécuter la commande suivante pour vérifier l'installation de NVM

nvm

Configurer Node en tant que service

Afin de configurer Node en tant que service, l'utilisation d'un "service systemd-user" est recommandé.

Rediriger le trafic vers un port spécifique

Prenez connaissance de cet autre guide au sujet des redirections de trafic vers un port spécifique et des IP dédiées.

Ce guide détaille l'installation de l'application desktop kDrive d'Infomaniak v4.x sur un ordinateur équipé du système d'exploitation macOS. Cette application permet de synchroniser automatiquement les fichiers de votre ordinateur avec votre espace kDrive en ligne.

Préambule

• L'installation de kDrive nécessite d'accorder certaines autorisations aux composants de l'application pour leur permettre de fonctionner sur votre ordinateur Apple.
  • Ce guide présente les manipulations à suivre sur les versions récentes de macOS ; pour les versions plus anciennes, prenez connaissance du dernier chapitre du guide.

Installer l'app kDrive 4.x sur macOS récent

Pour cela:

1. Ouvrez l'application téléchargée (❓: aide) et lancez l'installation sur votre ordinateur:
   
2. Lorsque l'installation est terminée:
   
   1. L'installateur indique le succès de l'opération.
   2. La fenêtre de configuration kDrive s'ouvre automatiquement.
   3. Une fenêtre de permissions/autorisations macOS s'ouvre également.
   4. et l'icône de l'app doit être visible en haut à droite sur macOS:
      
3. Il est indispensable d'effectuer la démarche d'autorisation demandée, il suffit pour cela de cliquer sur le bouton pour ouvrir les paramètres système puis d'activer le bouton à bascule (toggle switch) pour kDrive LiteSync Extension: 
   
4. Revenez sur la fenêtre de configuration et cliquez sur le bouton pour confirmer que vous avez bien effectué la modification demandée dans les paramètres système de macOS:
   
   • Si le bouton reste inactif, prenez connaissance du dernier chapitre du guide pour comparer votre configuration système et vous assurer d'avoir activé les bons paramètres.
5. Cliquez sur le bouton pour vous connecter à votre compte:
   
6. Le navigateur s'ouvre afin de vous permettre de vous connecter à votre compte Infomaniak qui conduit vers la ou les Organisations englobant votre kDrive.
7. Le navigateur peut demander votre autorisation d'intéragir avec l'application kDrive pour confirmer la connexion ; cliquez sur le bouton Ouvrir (si vous annulez par erreur, cliquez sur le lien pour obtenir la demande à nouveau).
8. Le navigateur peut être refermé ; sélectionnez le (ou les) kDrive parmi ceux auquel votre utilisateur a accès à synchroniser sur cet appareil puis cliquez sur Paramètres avancés:
   
9. Les Paramètres avancés vous permettent de choisir:
   1. l'emplacement dans lequel stocker les données kDrive (le dossier doit être vide),
   2. les dossiers déjà existants sur kDrive qu'il ne faut pas afficher sur cet appareil (❓: aide),
   3. s'il faut stocker les fichiers kDrive sur le disque avec leur taille réelle, ou s'ils peuvent être “virtuellement” listés, tout en étant stockés sur les serveurs distants (❓: aide).
   4. Confirmez en haut de page:
      
10. Cliquez sur le bouton Continuer à côté des paramètres avancés pour terminer l'installation et ouvrir l'interface ; l'app doit tourner en arrière-plan ce qui permet la synchronisation automatique ; vous devez apercevoir son icône en tout temps (❓: aide):
    
11. Prenez connaissance des autres guides pour continuer la découverte de l'application kDrive.

Désinstaller kDrive sur macOS

Pour cela:

1. Faites un clic droit sur l'icône et choisissez Quitter si l'app est encore en arrière-plan dans la barre des tâches en haut à droite:
   
2. Ouvrez ensuite l'application kDrive Uninstaller depuis le dossier kDrive de vos applications macOS et validez la suppression:
   
   • Vous devrez peut-être entrer vos informations de connexion à l'ordinateur.
3. Une fois l'application supprimée, vous pouvez si nécessaire supprimer le dossier de stockage contenant vos fichiers sur l'ordinateur:
   

Permissions kDrive selon les versions plus anciennes de macOS

Afin d'autoriser les composants kDrive v4.x à accéder correctement à votre ordinateur, suivez les indications visibles sur les captures d'écran correspondantes à votre version de macOS: 12 Monterey ; 13 Ventura ; 14 Sonoma ; 15 Sequoia ; 26 Tahoe ; 27 Golden Gate

macOS 12

macOS 13

macOS 14

macOS 15

macOS 26

macOS 27

Ce guide explique comment générer une demande de certificat (CSR) pour un nom de domaine et tous ses sous-domaines avec un Hébergement Web (hors hébergement gratuit de type Starter), permettant ainsi de chiffrer la connexion à votre nom de domaine et à tous ses sous-domaines via un certificat SSL unique.

Préambule

• La configuration permet d'avoir un "site nommé" et un "site backup" ; pour que cela fonctionne sans conflit, assurez-vous que le wildcard et vos sous-domaines précis ne se chevauchent pas sur le même hébergement Web:
  • Niveau DNS la priorité est naturelle: si un sous-domaine spécifique existe (ex: prive.domain.xyz), c'est lui qui est sollicité, sinon, la requête est redirigée vers le wildcard (*.domain.xyz).
  • Niveau Serveur il est nécessaire d'être vigilant: si le wildcard et le sous-domaine spécifique se trouvent sur le même serveur, c'est l'implémentation logicielle (Apache) qui décide ; Apache traite les requêtes selon l'ordre d'évaluation des fichiers de configuration.
  • Le risque : si le wildcard est évalué en premier, il "capture" tout le trafic, rendant votre sous-domaine spécifique inaccessible, même s'il existe par ailleurs.
  • Par conséquent il ne faut pas mettre le wildcard sur le même hébergement qu'un sous-domaine plus précis le chevauchant.

Mettre en place un certificat Wildcard

1. Ajouter un domaine alias avec astérisque *

Afin d'ajouter un alias de type * à votre site:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du site concerné.
3. Cliquez ensuite sur le chevron ‍ pour développer la partie Domaines de ce site.
4. Cliquez sur le bouton Ajouter un domaine:
   
5. Saisissez le nom de domaine à ajouter sous cette forme:
   • *.domain.xyz (l'astérisque est indispensable, suivie d'un point, puis du nom de domaine du site qui est dans cet exemple domain.xyz)
6. Cliquez sur le bouton Confirmer pour terminer la procédure:
   

2. Installer un certificat SSL ou le mettre à jour

Exemple de mise à jour du certificat existant afin d'inclure le sous-domaine * wildcard:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du site concerné.
3. Cliquez sur Certificat SSL dans le menu latéral gauche.
4. Cliquez sur le menu d'action ⋮ situé à droite.
5. Cliquez sur Mettre à jour le certificat:
   
6. Veillez à ce que le sous-domaine récemment ajouté soit bien sélectionné.
7. Cliquez sur le bouton Installer en bas:
   
8. Patientez le temps de la création ou de la mise à jour.

Ce guide explique comment installer et configurer systemd sur un Serveur Cloud et présente les principales commandes utilisables.

Prérequis

• Suivre le guide d'installation systemd pour Serveur Cloud.
• Consulter la documentation officielle pour prendre connaissance de l'ensemble des possibilités offertes par systemd
• Les fichiers "unit" devront être placés dans : ~/.config/systemd/user/ ( /home/clients/absolute-path-id/.config/systemd/user ) (en remplaçant absolute-path-id visible dans votre Manager) et les permissions doivent être réglées en 0644.
• Le paramètre --user doit être indiqué dans chaque commande.

Principales commandes 

Voici une liste non-exhaustives de commandes utilisables avec systemd.

Forcer systemd à lire à nouveau les unit files et à prendre en compte les modifications:

systemctl --user daemon-reload

Activation d'un service: 

systemctl --user enable --now SERVICENAME.service

Vérification de l'état d'un service:

systemctl --user status SERVICENAME.service

Configuration de Node en tant que service avec systemd

Il sera nécessaire de créer un fichier "Unit" avec l'extension ".service", qu'il faudra enregistrer dans le répertoire:

~/.config/systemd/user/

Il est possible de réutiliser l'exemple ci-après en remplaçant les valeurs commençant par {} :

[Unit]
Description={Le nom du service} # Spécifier ici un nom du service. Celui-ci est obligatoire mais n'a pas d'impact sur le fonctionnement
[Service]
Restart=always
Environment=NODE_VERSION={la version souhaitée} # Spécifier ici la version de Node à utiliser. S'assurer qu'elle soit installée au préalable avec "nvm install {la version souhaitée}"
WorkingDirectory=%h/{repertoire du projet Node} # %h correspond à la racine de l'hébergement
ExecStart=/bin/bash -c "exec $HOME/.nvm/nvm-exec {commande de lancement du script node}" # Cette commande dépend du projet. Par exemple, "npm run start", "npm run serve" ou encore "node server.js" sont courants
[Install]
WantedBy=default.target

Actions supplémentaires avec un fichier Unit

systemctl --user daemon-reload

Démarrer le service (si celui-ci est déjà actif, rien ne se passe):

systemctl --user start [Nom du Unit]

Arrêter le service (si celui-ci n'est pas actif, rien ne se passe):

systemctl --user stop [Nom du Unit]

Redémarrer le service (s'il ne tourne pas, il est lancé):

systemctl --user restart [Nom du Unit]

Obtenir des informations sur le service ; notamment:

• "Active" qui indique si le service tourne et depuis quand
• "CGroup" montre le groupe de processus que gère le service, ça permet de voir les processus actifs, avec leurs arguments et leur ID

En dessous de "CGroup" se trouvent d'éventuels logs (la sortie standard et erreur du processus):

systemctl --user status [Nom du Unit]

Activer le démarrage automatique du service au boot du serveur ; NB: ça ne démarre pas le service:

systemctl --user enable [Nom du Unit]

Désactiver le démarrage automatique du service au boot du serveur ; NB: ça n'arrête pas le service:

systemctl --user disable [Nom du Unit]

Configuration avec les entrées user:

[Unit]
Description="nom service"
[Service]
Restart=always
Environment=NODE_VERSION=16.17
WorkingDirectory=%h/sites/"nom-repertoire-site"/
ExecStart=/bin/bash -c "exec $HOME/.nvm/nvm-exec npm run start"
[Install]
WantedBy=default.target

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 installer l'Agent de sauvegarde Acronis pour Swiss Backup sur les Mac d'Apple équipés de processeurs M1, M2... utilisant une architecture ARM plutôt que l'architecture x86 utilisée habituellement.

Prenez connaissance de cet autre guide si vous recherchez des informations au sujet de la désinstallation.

Installer l'Agent Acronis spécifique ARM

Pour accéder à l'interface de gestion Acronis:

1. Cliquez ici afin d'accéder à la Console Acronis avec les identifiants obtenus suite à l'ajout de l'appareil (besoin d'aide ?).
2. Cliquez sur l'icône utilisateur tout en haut à droite.
3. Cliquez sur Téléchargements:
   
4. Choisissez le client adapté à votre machine:
   

Attention

Si vous prenez la version disponible depuis le menu latéral gauche, elle ne sera pas compatible:

• Ne pas suivre cette méthode ci-dessous car la version obtenue ne sera pas la bonne (version Intel):
  
  

Jelastic propose un add-on qui permet d'installer des paquets nécessitant des permissions sudo sans avoir besoin d'un accès root.

Informations complémentaires

L'add-on Yum Packages Installer permet d'installer des paquets non fournis par défaut dans les conteneurs Jelastic (paquets RPM, outils de développement, etc.) en utilisant yum. Il offre une alternative pour installer des paquets lorsqu'un accès root direct n'est pas disponible.

Toutes les informations requises pour utiliser cet add-on sont décrites dans le readme de l'add-on.

Exemples d'actions courantes effectuées via l'add-on :

• Installer des outils de compilation : gcc autoconf make
• Installer un RPM externe : fournir l'URL complète du RPM dans le champ d'installation.

Ce guide explique comment installer rapidement des applications, extensions PHP et technologies (liste non exhaustive ci-dessous) en quelques clics sur Serveur Cloud uniquement.

Installer (ou désinstaller) des apps / extensions PHP…

Pour trouver la liste des technologies et procéder à leur installation:

1. Cliquez ici afin d'accéder à la gestion de votre Serveur Cloud sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au Serveur Cloud concerné:
   
3. Cliquez dans le menu latéral gauche:
   1. Extensions PHP
      
   2. Fast Installer
      
4. Cliquez sur le menu d'action ⋮ à droite de l'extension que vous souhaitez désinstaller dans le tableau qui s'affiche.
5. Cliquez sur Désinstaller.
6. Sinon cliquez sur le bouton bleu Installer une extension / Installer une application:
   
7. Puis faites votre choix de nouvelle installation‍:
   

Liste non exhaustive des apps & extensions disponibles

• AdvanceCOMP
• BuildEssential
• electron_dev
• ExifTool
• FFmpeg ↗ guide
• Ghostscript
• Gifsicle
• GraphicsMagick
• HAProxy
• Imagemagick ↗ guide
• Jpegoptim
• libjpeg_turbo
• libqrencode
• libX11_xcb1
• MidnightCommander
• Memcached ↗ guide
• mongoDB ↗ guide
• NVM Node Version Manager
• OptiPNG
• p7zip
• PDFtk
• PHP_APCu
• PHP_CLI ↗ guide
• PHP_FPM
• PHP_GnuPG (extension obsolète) ↗ guide pour l'alternative PHP pure
• PHP_gRPC
• PHP_igbinary
• PHP_IonCube ↗ guide
• PHP_OPcache
• PHP_PDF
• PHP_PDO_ODBC ↗ guide
• PHP_Swoole
• pip
• Pngcrush
• Pngquant
• Redis ↗ guide
• RRDTool The Round Robin Database Tool
• RubyCompass
• systemd ↗ guide
• tesseract_ocr
• varnish ↗ guide
• virtualenv
• WebP
• xauth
• xpdf
• xvfb
• ZSH