installation

🔧 Installation

Guide complet pour installer Nihil sur votre système.

Prérequis

• Docker installé et fonctionnel
• Python 3.12+
• pipx (recommandé) ou pip

Vérifier Docker

docker --version
docker ps

Si Docker n'est pas installé, suivez la documentation officielle.

Installation de Nihil

Méthode 1 : Installation avec pipx (recommandé)

# Installer pipx si nécessaire
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# Cloner le repository
git clone https://github.com/NihilOps/nihil.git
cd nihil

# Installer Nihil en mode développement
pipx install -e .

Méthode 2 : Installation avec pip

git clone https://github.com/NihilOps/nihil.git
cd nihil
pip install -e .

Construction de l'image Docker

L'image Docker contient l'environnement de pentest complet avec tous les outils.

cd nihil-images
docker build -t nihil:local .

Options de build

Vous pouvez personnaliser l'image avec des arguments :

docker build \
  --build-arg TAG="v1.0" \
  --build-arg VERSION="1.0.0" \
  --build-arg BUILD_DATE="$(date -u +'%Y-%m-%dT%H:%M:%SZ')" \
  -t nihil:local .

Vérification de l'installation

# Vérifier que nihil est installé
nihil --version

# Vérifier l'environnement
nihil doctor

# Lister les images disponibles
nihil info

Mise à jour

cd nihil
git pull
pipx install -e . --force

Désinstallation

# Désinstaller nihil
pipx uninstall nihil

# Supprimer les images Docker
nihil uninstall

Problèmes courants

Docker n'est pas accessible

# Vérifier que Docker est en cours d'exécution
sudo systemctl start docker

# Vérifier les permissions
sudo usermod -aG docker $USER
# Puis reconnectez-vous

pipx non trouvé

# Installer pipx
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# Recharger le shell
source ~/.bashrc  # ou ~/.zshrc

Erreur de permissions Docker

# Ajouter votre utilisateur au groupe docker
sudo usermod -aG docker $USER
newgrp docker

Support

Si vous rencontrez des problèmes, consultez la FAQ ou ouvrez une issue sur GitHub.