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 terminal-managed deployments​

If you used uvx to install OpenRAG, clear your uv cache (uv cache clean), and then delete the ~/.openrag directory.

If you used uv to install OpenRAG, run uv remove openrag in your Python project, and then delete the ~/.openrag directory.

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

  2. Remove and clean up containers:

    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

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

  4. Stop docling-serve:

    uv run python scripts/docling_ctl.py stop