Installation

Prérequis

Avant d'installer Mithrandir, assurez-vous d'avoir :

• Un serveur Debian ou Ubuntu (y compris Raspberry Pi OS)
• Un accès root ou sudo
• Git installé (sudo apt install git)

Installer

Clonez le dépôt et lancez le script d'installation :

git clone https://github.com/Joel-Mercier/mithrandir.git
cd homelab
sudo bash install.sh

Le script d'installation effectue automatiquement les étapes suivantes :

1. Installe les dépendances système (curl, unzip)
2. Installe Bun (runtime JavaScript) et crée un lien symbolique dans /usr/local/bin
3. Installe les dépendances du projet (bun install)
4. Compile le bundle CLI (bun run build)
5. Crée la commande globale mithrandir dans /usr/local/bin/mithrandir

Une fois terminé, vérifiez l'installation :

mithrandir version

TIP

Si bun n'est pas trouvé dans une nouvelle session de terminal, exécutez source ~/.bashrc (ou source ~/.zshrc pour Zsh) pour recharger votre profil shell.

TIP

Il est fortement recommandé d'attribuer une adresse IP DHCP statique à votre serveur afin que son adresse IP ne change jamais. Vous pouvez configurer cela dans les paramètres de baux statiques DHCP de l'interface web de votre routeur.

Complétions shell

Configurez l'auto-complétion pour votre shell :

Bash

# Ajouter au profil shell pour persister les complétions entre les sessions
mithrandir completions bash >> ~/.bashrc
source ~/.bashrc

Zsh

# Ajouter au profil shell pour persister les complétions entre les sessions
mithrandir completions zsh >> ~/.zshrc
source ~/.zshrc

Fish

# Fish charge automatiquement les fichiers de complétion depuis ce répertoire
mithrandir completions fish > ~/.config/fish/completions/mithrandir.fish

Étapes suivantes

Une fois Mithrandir installé, lancez l'assistant de configuration pour configurer votre homelab :

mithrandir setup

Mise à jour

Pour mettre à jour la CLI vers la dernière version :

mithrandir self-update

Cela récupère les derniers changements depuis git, réinstalle les dépendances et recompile la CLI.

Désinstallation

Pour supprimer Mithrandir de votre système :

sudo rm /usr/local/bin/mithrandir

Cela supprime la commande CLI. Vos données d'applications, conteneurs Docker et configuration .env dans le répertoire du projet restent intacts — supprimez-les manuellement si vous souhaitez repartir de zéro.