The current version is #ident "@(#)$Format:LocalFoodAI_lanfr144:Uninstall_Guide.md:%an:%ae:%ad:%cn:%ce:%cd:%H:%D:%N$"


# Local Food AI - Uninstallation & Teardown Guide

This document outlines the standard uninstallation procedures to completely remove the **Local Food AI** stack components from both Windows hosts and Linux/WSL deployment environments.

---

## 1. Linux & WSL Client Uninstallation

To cleanly purge the containerized services, databases, virtual environments, and log files:

### Step 1.1: Stop & Remove Docker Containers & Volumes
Bring down the Docker Compose stack and permanently delete all associated network interfaces and database volumes:
```bash
# Navigate to the project directory
cd /dossier/du/projet/Food

# Stop services and remove containers, networks, and volumes
./manage_services.sh stop
docker compose down -v
```
*Note: The `-v` flag is critical as it completely purges the MySQL persistent data directories.*

### Step 1.2: Remove Local Project Docker Images
List the active images associated with the project using:
```bash
docker image ls | grep -E "food_project|zabbix|searxng|ollama|nginx|airflow"
```
Example output:
```text
IMAGE                                             ID             DISK USAGE   CONTENT SIZE   EXTRA
apache/airflow:2.8.1                              e5560ad0b86e       1.94GB          387MB    U
food_project-app:latest                           3cfb2e77efc7        1.4GB          326MB    U
food_project-ingest:latest                        6e120f3c9946        1.4GB          326MB
food_project-mysql:latest                         6f33177ab088       1.09GB          234MB    U
nginx:latest                                      6e23479198b9        240MB         65.8MB    U
ollama/ollama:latest                              5600a652d108       10.1GB         3.77GB    U
searxng/searxng:latest                            25ff3c045548        375MB         96.4MB    U
zabbix/zabbix-agent:ubuntu-7.0-latest             db7d6490f39a        202MB         56.2MB    U
zabbix/zabbix-server-mysql:ubuntu-7.0-latest      78c2e2f75e8d        479MB          121MB    U
zabbix/zabbix-web-nginx-mysql:ubuntu-7.0-latest   11b12c432e1b        557MB          145MB    U
```

To permanently remove all the images related to the application stack from the local cache:
```bash
docker rmi food_project-app:latest food_project-ingest:latest food_project-mysql:latest nginx:latest ollama/ollama:latest searxng/searxng:latest zabbix/zabbix-agent:ubuntu-7.0-latest zabbix/zabbix-server-mysql:ubuntu-7.0-latest zabbix/zabbix-web-nginx-mysql:ubuntu-7.0-latest apache/airflow:2.8.1
```

### Step 1.3: Clean Up Virtual Environments, Logs & Backups
Delete local administrator logs, backup directories, and Python virtual environment libraries:
```bash
rm -rf .venv/
rm -rf backups/
rm -rf logs/
rm -rf data/
```

### Step 1.4: Purge Docker CE (Optional)
If you wish to completely uninstall Docker CE from the Ubuntu/WSL environment:
```bash
sudo apt-get purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
```

---

## 2. Windows Host Uninstallation

To remove all hypervisor and subsystem configurations from the Windows client:

### Step 2.1: Unregister and Delete the WSL Subsystem Environment
To completely wipe the WSL2 Ubuntu environment and its entire virtual hard disk (VHD):
1. Open a PowerShell terminal as Administrator.
2. Execute the unregister command:
```powershell
wsl --unregister Dopro1
```
*Warning: This action is irreversible. All configurations, tools, and code inside the WSL `Dopro1` container will be permanently deleted.*

### Step 2.2: Remove VirtualBox Virtual Machines (if applicable)
If you deployed Ollama or Zabbix nodes on dedicated VirtualBox VMs:
1. Open PowerShell or Command Prompt.
2. Run the VBoxManage tool to remove the VMs:
```cmd
VBoxManage unregistervm "Ollama_Server" --delete
VBoxManage unregistervm "Zabbix_Server" --delete
```

### Step 2.3: Disable Windows Virtualization Features (Optional)
To disable WSL and Virtual Machine Platform features on the Windows host:
```powershell
Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Disable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
```
*Note: A system reboot is required to complete this step.*