Uninstall_Guide.md 4.3 KB
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):
- Open a PowerShell terminal as Administrator.
Execute the unregister command:
wsl --unregister Dopro1Warning: This action is irreversible. All configurations, tools, and code inside the WSL
Dopro1container will be permanently deleted.
Step 2.2: Remove VirtualBox Virtual Machines (if applicable)
If you deployed Ollama or Zabbix nodes on dedicated VirtualBox VMs:
- Open PowerShell or Command Prompt.
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.