...

AKR Updater

1.7.3

...

💻 Commande d'installation
curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash

Ce guide pratique vous détaille l'utilisation pas à pas du logiciel, de la découverte de l'interface web à la mise en place de vos premières tâches planifiées. Vous y apprendrez également à lier votre compte Discord pour piloter vos redémarrages à distance.

Avant de lancer le déploiement de l'application, découvrez la marche à suivre pour configurer rapidement votre hôte dans les règles de l'art. L'ensemble de la procédure repose sur une commande shell unique exécutée dans votre terminal Linux.

Installation

1

Préparation de l'environnement Linux

Démarrez un système Linux ou créez un conteneur LXC dédié et propre afin d'accueillir le service. Assurez-vous de disposer d'un accès terminal avec les privilèges d'administration sudo et d'une connexion réseau active pour télécharger les fichiers nécessaires.

2

Exécution de la commande d'installation

Ouvrez votre terminal et collez la commande exacte suivante : curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Validez l'exécution pour lancer le script officiel d'installation automatisée.

3

Attente de la configuration automatique

Laissez le processus d'installation déployer les fichiers et configurer les services d'arrière-plan. Le script s'exécute de manière autonome en quelques secondes pour préparer les composants nécessaires au fonctionnement du système.

4

Vérification des ports réseau

Contrôlez que le port TCP 8080 est bien accessible depuis votre réseau local ou autorisez-le dans vos règles de pare-feu applicatives. Ce port est indispensable pour communiquer avec l'interface graphique d'administration hébergée par le logiciel.

5

Accès au panneau d'administration web

Lancez votre navigateur web et rendez-vous à l'adresse IP de votre serveur suivie du port 8080 (par exemple http://IP_SERVEUR:8080). Vous arrivez sur l'écran d'accueil du panneau dédié à la gestion de vos serveurs.

6

Ajout du premier serveur distant

Depuis le panneau web, enregistrez votre première machine cible en renseignant son adresse et les identifiants requis pour la liaison initiale. Le système générera la clé SSH chiffrée, scellant l'accès sécurisé pour les futures opérations de maintenance.

Guide d'utilisation

Navigation dans le panneau d'administration web

Le tableau de bord accessible sur le port 8080 centralise l'état de l'ensemble de vos machines enregistrées. Vous pouvez y observer le statut global de votre parc, vérifier les dernières opérations exécutées et parcourir l'historique complet des actions. Cet espace constitue le point névralgique pour orchestrer vos interventions techniques sans ouvrir de multiples sessions SSH.

Planification des tâches et du trim SSD

Depuis la section de planification, définissez la fréquence à laquelle vos paquets système doivent être inspectés et mis à niveau. Vous pouvez également intégrer l'optimisation trim SSD pour conserver de bonnes performances sur vos supports de stockage flash. Une fois enregistrée, la routine s'exécute automatiquement en arrière-plan selon le calendrier établi.

Configuration des alertes et du bot Discord

Pour assurer un suivi à distance, paramétrez vos canaux d'alerte en saisissant un webhook Discord ou en activant le bot intégré. En mode bot, vous recevrez des encarts détaillés après chaque exécution de tâche. Ces notifications enrichies intègrent des boutons d'interaction permettant de relancer une machine ou de programmer son redémarrage d'un simple clic.

Administration des instances NetBird

Si votre infrastructure repose sur NetBird, le logiciel prend en charge la gestion des versions de vos composants. Vous pouvez appliquer les mises à niveau tant sur le client que sur l'infrastructure NetBird SelfHosted directement via l'outil. Cette intégration native assure la cohérence des versions de votre réseau superposé sans manipulation manuelle complexe.

Surveillance des journaux et traçabilité

Consultez régulièrement l'historique des opérations sur l'interface pour auditer les actions menées sur vos machines. En cas d'anomalie sur un service suite à une mise à niveau, le journal vous permet de vérifier précisément quels paquets ont été traités et à quel moment. Cette visibilité facilite l'analyse et la maintenance préventive de vos environnements.

Ces conseils d'utilisation ont été formulés pour vous aider à tirer le meilleur parti de votre panneau de contrôle et à optimiser la sécurité de votre parc. Mettez en pratique ces recommandations pour préserver la stabilité de vos environnements Linux.

Astuces

Privilégiez un conteneur LXC dédié

Installez l'outil au sein d'une instance LXC vierge pour isoler l'administration de vos serveurs de vos charges applicatives courantes. Cela simplifie les sauvegardes globales et préserve l'intégrité de votre serveur de supervision.

Planifiez en dehors des heures de forte activité

Programmez vos cycles de mises à jour et de trim SSD pendant les créneaux creux de la nuit. Vous éviterez ainsi tout ralentissement disque imprévu ou toute indisponibilité passagère pour vos utilisateurs.

Exploitez les boutons d'action Discord

Configurez le mode bot Discord plutôt qu'un webhook passif pour bénéficier des boutons interactifs de redémarrage. Cela vous permet de valider une relance système depuis votre mobile sans devoir vous connecter au tableau de bord.

Surveillez les paquets du noyau

Soyez attentif aux notifications signalant une mise à jour du noyau Linux. Planifiez alors un redémarrage rapide de l'hôte pour charger la nouvelle version sécurisée sans laisser la machine dans un état intermédiaire.

Vérifiez vos clés SSH enregistrées

Puisque l'outil chiffre automatiquement les clés SSH générées, veillez à ne pas modifier manuellement les permissions des répertoires de clés sur les cibles. Laissez l'outil gérer ses accès pour éviter toute rupture de communication.

Centralisez vos nœuds NetBird

Regroupez la supervision de vos clients NetBird et de votre serveur SelfHosted sur le même tableau de bord. Cela garantit une homogénéité parfaite des protocoles et limite les risques d'incompatibilité entre versions du réseau.

Consultez l'historique avant toute modification majeure

Avant d'installer une nouvelle application lourde sur un serveur distant, vérifiez dans l'historique que la dernière maintenance s'est achevée sans erreur. Vous partez ainsi d'une base logicielle parfaitement saine et à jour.

Vérifiez la connectivité du port 8080

Si vous gérez vos machines via un réseau distant, songez à placer le panneau web derrière un tunnel sécurisé ou à filtrer rigoureusement les adresses IP autorisées à joindre le port 8080.

En cas d'imprévu lors de l'accès au panneau web ou de la communication avec une machine distante, consultez cette rubrique de dépannage. Elle rassemble les solutions concrètes aux blocages techniques les plus couramment rencontrés.

Dépannage

⚠️ L'interface web sur le port 8080 refuse de se charger après l'installation
Vérifiez que le service est actif sur votre machine hôte en consultant les processus en cours dans le terminal. Assurez-vous que le pare-feu local n'intercepte pas les connexions sur le port 8080 et contrôlez que l'adresse IP utilisée est joignable depuis votre poste.
⚠️ Échec de connexion lors de l'ajout d'une nouvelle machine cible
Contrôlez que le serveur distant est joignable en réseau et que le service SSH y fonctionne correctement. Vérifiez que les identifiants administrateur temporaires saisis sont exacts afin que le logiciel puisse déployer sa clé chiffrée initiale.
⚠️ Les alertes Discord ne parviennent pas sur le serveur de discussion
Inspectez l'URL du webhook ou le jeton du bot Discord configuré dans les réglages du panneau. Assurez-vous que le salon textuel ciblé accorde les permissions d'écriture et d'envoi de messages enrichis (embeds) au bot.
⚠️ Les boutons interactifs Discord ne déclenchent pas le redémarrage
Assurez-vous que vous utilisez bien le mode bot Discord et non un simple webhook, car ce dernier ne permet pas l'interactivité. Vérifiez également que la communication sortante depuis votre hôte vers l'API Discord n'est pas bloquée.
⚠️ L'opération de trim SSD échoue sur un serveur spécifique
Vérifiez si le stockage de la machine cible repose bien sur un support SSD compatible avec la commande fstrim. Dans le cas d'une machine virtuelle ou d'un conteneur, l'option d'émulation SSD ou l'accès aux commandes de discard doit être activée sur l'hyperviseur.
⚠️ La mise à jour de NetBird SelfHosted ne progresse plus
Consultez les journaux d'historique dans l'interface web pour repérer d'éventuels conflits de paquets ou de conteneurs. Assurez-vous que l'instance NetBird dispose d'un espace disque suffisant pour télécharger et décompresser les nouveaux binaires.
⚠️ Interruption de la commande curl lors de l'installation initiale
Vérifiez la stabilité de votre connexion internet et assurez-vous que les paquets curl et sudo sont bien installés sur votre système de base. Relancez ensuite la commande curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash dans votre terminal.
⚠️ Le redémarrage planifié ne s'est pas exécuté à l'heure prévue
Contrôlez la synchronisation horaire (fuseau horaire et service NTP) entre le serveur exécutant l'Updater et la machine distante. Une divergence d'horloge peut différer l'exécution des planifications programmées.

Prenez connaissance des prérequis matériels et système indispensables pour assurer un fonctionnement optimal du panneau web et de ses tâches d'arrière-plan. Conçu pour rester très économe, l'outil s'adapte aux configurations matérielles modestes.

Config. requise

Configuration minimale

OSDistribution Linux moderne (recommandé en conteneur LXC neuf)
ProcesseurProcesseur 1 cœur 64 bits
RAM512 Mo de mémoire vive
Stockage1 Go d'espace libre
RéseauAccès Internet pour le téléchargement et les dépôts de paquets

Configuration recommandée

OSDistribution Linux moderne en conteneur LXC dédié
ProcesseurProcesseur 2 cœurs
RAM1 Go de mémoire vive ou plus
Stockage5 Go d'espace libre pour les historiques et journaux
RéseauConnexion haut débit et port 8080 ouvert sur le réseau local