Ce guide vous accompagne dans le déploiement de votre première infrastructure avec Siovos Desktop. Le processus prend généralement 15 à 30 minutes selon les spécifications de votre serveur.

Avant de commencer#

Assurez-vous d'avoir :

Siovos Desktop installé et la licence activée
Un serveur distant (VPS) avec Debian 13
Un accès SSH root à votre serveur
L'adresse IP de votre serveur
Une clé privée SSH pour l'authentification

Spécifications serveur recommandées :

CPU : 2+ cœurs
RAM : 8 Go minimum (16 Go recommandé)
Disque : 40 Go+ SSD
Réseau : Adresse IP publique

Étape 1 : Lancer l'assistant de configuration#

Ouvrez Siovos Desktop
Cliquez sur « Nouveau déploiement » depuis le tableau de bord
L'assistant de configuration se lance

Étape 2 : Configuration du serveur#

Vous devrez fournir les détails de votre serveur :

Informations serveur#

Adresse IP du serveur : L'IP publique de votre VPS (ex : 203.0.113.42)
Utilisateur SSH : Généralement root (ou un utilisateur sudo)
Port SSH : Par défaut 22
Clé privée SSH : Cliquez sur « Parcourir » pour sélectionner votre fichier de clé SSH

Sécurité de la clé SSH : Votre clé SSH n'est utilisée que pendant le déploiement et n'est jamais envoyée à des serveurs externes. Elle reste chiffrée sur votre machine locale.

Tester la connexion#

Cliquez sur « Tester la connexion » pour vérifier que Siovos Desktop peut atteindre votre serveur. Cela va :

Vérifier que l'adresse IP est joignable
Tester l'authentification SSH
Vérifier la compatibilité du système d'exploitation
Vérifier l'accès root/sudo

Si le test échoue, consultez le guide de dépannage.

Étape 3 : Choisir un profil de déploiement#

Siovos Desktop propose des profils de déploiement préconfigurés pour simplifier votre installation. Choisissez celui qui correspond le mieux à vos besoins :

Profils disponibles#

Minimal (Solo)

Infrastructure essentielle pour les workloads Kubernetes de base :

K3s (Kubernetes)
VPN WireGuard
DNS

Ressources : 1-2 cœurs, 2-4 Go RAM, 20-30 Go stockage

Léger (Team)

Infrastructure minimale avec interface de gestion :

Tout ce qui est dans Minimal
Interface Rancher (gestion Kubernetes)

Ressources : 2-4 cœurs, 4-8 Go RAM, 30-50 Go stockage

Standard (Team) — Recommandé

Infrastructure complète prête pour la production :

Tout ce qui est dans Minimal
Harbor (registry Docker)
PostgreSQL (base de données)
Step-CA (certificats PKI)

Ressources : 4-6 cœurs, 8-12 Go RAM, 50-100 Go stockage

Développeur (Team)

Optimisé pour les workflows de développement :

Tout ce qui est dans Minimal
Interface Rancher
Step-CA (PKI)

Ressources : 2-4 cœurs, 6-10 Go RAM, 40-80 Go stockage

Infrastructure complète (Business)

Stack complète avec tous les services :

Tous les services disponibles

Ressources : 8+ cœurs, 16+ Go RAM, 100+ Go stockage

Personnaliser les mots de passe (optionnel)#

Avant d'appliquer un profil, vous pouvez personnaliser les mots de passe des services inclus :

Cliquez sur « Personnaliser » sur le profil choisi
Une fenêtre s'ouvre avec les champs de mot de passe pour WireGuard, Harbor, PostgreSQL, Step-CA
Entrez vos propres mots de passe ou cliquez sur le bouton actualiser pour en générer des sécurisés
Cliquez sur « Continuer avec ce profil » pour appliquer

Conseil sécurité : Les mots de passe générés font 16 caractères avec un mélange de lettres, chiffres et caractères spéciaux.

Configuration à la carte (Business)#

Les utilisateurs avec une licence Business peuvent configurer les services individuellement au lieu d'utiliser un profil prédéfini :

Cliquez sur « Configuration manuelle » en bas de la liste des profils
Activez ou désactivez chaque service selon vos besoins
Les dépendances sont gérées automatiquement (activer Harbor active aussi K3s)
Configurez les sous-domaines DNS via le bouton « DNS »

Cette option permet une flexibilité totale pour les infrastructures avec des besoins spécifiques.

Étape 4 : Configurer le domaine et le réseau#

Configurez comment vos services seront accessibles :

Domaine de base : (Optionnel) ex : myinfra.com pour les sous-domaines de services
Réseau VPN : Par défaut 10.8.0.0/24 (généralement correct)
Mot de passe admin : Définissez un mot de passe fort pour les interfaces web

Étape 5 : Vérifier et déployer#

Vérifiez le résumé de votre configuration. L'assistant affiche :

Les services sélectionnés
Les ressources serveur qui seront utilisées
Les URLs d'accès post-déploiement

Quand vous êtes prêt, cliquez sur « Démarrer le déploiement ».

Étape 6 : Suivre la progression#

Le déploiement s'exécute automatiquement sur votre serveur. Vous verrez en temps réel :

La tâche en cours d'exécution
Le pourcentage de complétion
Les logs détaillés (dépliables)

Soyez patient : Les premiers déploiements prennent plus de temps car les packages sont téléchargés et les services configurés. Les déploiements suivants seront plus rapides.

Phases de déploiement#

Phase	Tâches
Préparation système	Mise à jour des packages, installation des prérequis, configuration du firewall
Services de base	Déploiement du cluster K3s, configuration réseau, installation du stockage
Services sélectionnés	Déploiement de chaque service sélectionné, configuration des intégrations
Configuration VPN	Installation de WireGuard, génération de la config client

Étape 7 : Récupérer les artefacts#

Une fois le déploiement terminé, Siovos Desktop télécharge automatiquement :

Fichier de configuration WireGuard (wg0.conf)
Certificat racine pour l'accès HTTPS
Identifiants d'accès pour les services
Instructions de connexion

Étape 8 : Installer le certificat racine#

Pour accéder aux services HTTPS sans avertissements du navigateur, installez le certificat racine :

Après le déploiement, cliquez sur « Installer le certificat racine » dans la bannière verte
Ou plus tard : allez dans Mes Infrastructures → votre serveur → onglet Actions → « Installer le certificat racine »

Utilisateurs macOS : Vous devrez approuver manuellement le certificat dans Réglages Système → Général → Gestion des appareils. Consultez notre guide d'installation du certificat pour plus de détails.

Étape 9 : Se connecter au VPN#

Pour accéder à vos services déployés :

Allez dans l'onglet VPN dans Siovos Desktop
La configuration WireGuard est automatiquement chargée
Cliquez sur « Connecter »
Attendez la confirmation de connexion

Étape 10 : Accéder à vos services#

Une fois connecté au VPN, vous pouvez accéder à vos services :

Service	URL par défaut	Identifiants
Rancher	`https://rancher.internal`	Défini pendant le déploiement
Harbor	`https://registry.internal`	admin / (mot de passe du déploiement)
API Kubernetes	`https://10.8.0.1:6443`	Voir kubeconfig

Prochaines étapes#

Félicitations ! Votre infrastructure est maintenant déployée. Vous pouvez :

Déployer des applications conteneurisées sur Kubernetes
Pousser des images Docker vers votre registry Harbor privé
Gérer votre cluster via Rancher
Stocker les données applicatives dans PostgreSQL

Besoin d'aide ? Contactez le support

Premier déploiement