LocalFoodAI_lanfr144/docs/Uninstall_Guide.md

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:

# 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:

docker image ls | grep -E "food_project|zabbix|searxng|ollama|nginx|airflow"

Example output:

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:

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:

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:

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:

   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:

   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:

Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Disable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

Note: A system reboot is required to complete this step.