Project Nomad installation guide: Kali linux edition

Installing Project Nomad on Kali requires manual intervention because the default script's Docker installation logic is incompatible with Kali's rolling repositories.

1. System Specifications

• OS: Kali Linux (Rolling)
• Hardware: 16GB RAM / 1TB SSD / Nvidia RTX 3060

2. Pre-Installation: Fix Docker Repositories

The official Nomad script often fails on Kali because it adds an invalid repository. If the script failed previously, you must clean the system first.

# Remove the broken Docker repository added by the script
sudo rm /etc/apt/sources.list.d/docker.list

# Refresh package lists
sudo apt update

3. Manual Dependency Installation

Instead of letting the script handle Docker, install the version maintained specifically for Kali.

# Install Docker and Docker-Compose from Kali repos
sudo apt install -y docker.io docker-compose

# Enable and start the Docker service
sudo systemctl enable docker --now

# (Optional) Add your user to the docker group
sudo usermod -aG docker $USER

Note: You must log out and back in for the group change to take effect.

4. Run the Nomad Installer

Once Docker is manually verified as running (systemctl status docker), run the installer. It will detect Docker and skip the broken installation steps.

# Download the script if not already present
curl -fsSL [https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/main/install/install_nomad.sh](https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/main/install/install_nomad.sh) -o install_nomad.sh

# Execute the local script
sudo bash install_nomad.sh

5. Post-Install: GPU Acceleration (Nvidia 3060)

To ensure the AI Assistant uses the RTX 3060 instead of the CPU, install the Nvidia Container Toolkit.

# Install the toolkit
curl -fsSL [https://nvidia.github.io/libnvidia-container/gpgkey](https://nvidia.github.io/libnvidia-container/gpgkey) | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L [https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list](https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list) | \
  sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
  sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

sudo apt update
sudo apt install -y nvidia-container-toolkit

# Restart Docker to apply GPU passthrough
sudo systemctl restart docker

6. Access & Management

• Web UI: http://localhost:8080
• Start Nomad: cd /opt/project-nomad && sudo ./start_nomad.sh
• Stop Nomad: cd /opt/project-nomad && sudo ./stop_nomad.sh
• Check Ports: sudo ss -tulpn | grep LISTEN

7. Operational Notes

• Resource Conflict: Stop Nomad before using Hashcat to avoid VRAM contention on the 3060.
• Isolation: Nomad runs in Docker containers; it does not overwrite or interfere with Kali’s native security tools.