Skip to main content

Remove OpenRAG

tip

If you want to reset your OpenRAG containers without removing OpenRAG entirely, see Reset OpenRAG containers and Reinstall OpenRAG.

Uninstall TUI-managed deployments​

If you used the automated installer script or uvx to install OpenRAG, clear your uv cache (uv cache clean) to remove the TUI environment, and then delete the directory containing your OpenRAG configuration files and data (where you would invoke OpenRAG).

If you used uv to install OpenRAG, run uv remove openrag in your Python project.

Uninstall self-managed deployments​

For self-managed services, destroy the containers, prune any additional container objects, delete any remaining OpenRAG files, and then shut down the Docling service.

Uninstall with docker compose or podman compose​

Use these steps to uninstall a self-managed OpenRAG deployment with streamlined docker compose or podman compose commands:

  1. Destroy the containers, volumes, and local images, and then remove (prune) any additional container objects:

    Docker
    docker compose down --volumes --remove-orphans --rmi local
    docker system prune -f
    Podman
    podman compose down --volumes --remove-orphans --rmi local
    podman system prune -f

  2. Remove OpenRAG's .env file and the ~/.openrag/documents directory, which aren't deleted by the previous commands.

  3. Stop docling-serve:

    uv run python scripts/docling_ctl.py stop

Uninstall with discrete docker or podman commands​

Use these commands to uninstall a self-managed OpenRAG deployment with discrete docker or podman commands:

  1. Stop all running containers:

    Docker
    docker stop $(docker ps -q)
    Podman
    podman stop --all

  1. Remove all containers, including stopped containers:

    Docker
    docker rm --force $(docker ps -aq)
    Podman
    podman rm --all --force

  2. Remove all images:

    Docker
    docker rmi --force $(docker images -q)
    Podman
    podman rmi --all --force

  3. Remove all volumes:

    Docker
    docker volume prune --force
    Podman
    podman volume prune --force

  4. Remove all networks except the default network:

    Docker
    docker network prune --force
    Podman
    podman network prune --force

  5. Clean up any leftover data:

    Docker
    docker system prune --all --force --volumes
    Podman
    podman system prune --all --force --volumes

  1. Remove OpenRAG's .env file and the ~/.openrag/documents directory, which aren't deleted by the previous commands.

  2. Stop docling-serve:

    uv run python scripts/docling_ctl.py stop