8 min read July 19, 2026

How to Uninstall Odysseus AI Without Losing the Data You Want to Keep

Docker, Windows, macOS, and Linux cleanup guide

Odysseus AI Wiki
Odysseus AI Wiki
Fan-made technical guidance based on the current official repository.
Editorial illustration of backing up data before removing a self-hosted AI workspace
Editorial illustration, not a product screenshot.

Quick answer: Stop the app, back up workspace data, identify Docker or native installation, then remove code, persistent data, secrets, and shared model services separately.

Contents

Uninstalling Odysseus AI is not one universal command because it can run through Docker Compose or native scripts. Separate application code from volumes, databases, uploads, credentials, and Ollama models. The official repository was checked on July 19, 2026; it had no releases or tags that support a verifiable version claim.

Before deleting anything

Record how Odysseus was started and back up documents, notes, exports, database files, and settings outside the repository.

Choose the correct uninstall path

Use the Docker path when docker compose ps shows Odysseus services. Use the native path when launch scripts or manual Python/frontend commands ran on the host.

Path Remove first Keep unless intentional
Docker Compose Containers and network Volumes, mounts, Ollama models
Native scripts Processes and repository Shared runtimes and tools
Privacy reset App data and copied secrets Verified non-secret notes

Remove Docker Compose

Run docker compose down first. It removes containers and networks while normally preserving named volumes. Use docker compose down -v only after inspecting and backing up persistent data.

Odysseus AI Docker Compose workflow diagram
Inspect persistent volumes before deleting Docker data.

Remove a native installation

Stop backend and frontend processes, then remove the cloned repository. Delete only Odysseus-specific startup tasks, services, shortcuts, or firewall rules; keep shared Python, Node, Git, Docker, and Ollama tools when other projects need them.

Windows WSL2 Docker and Ollama setup diagram
Shared system tools and Ollama should be removed separately.

Decide what to keep

Treat repository code, database/uploads, .env secrets, logs, Docker volumes, bind mounts, and Ollama models as separate data groups. Privacy cleanup should also check backups and the recycle bin.

Verify the uninstall

Confirm the former local URL no longer responds, no project container or process remains, and the repository is deleted or archived. Reinstall from the current official repository and active branch documentation.

  1. Stop

    Stop the application and related containers or processes.

  2. Remove

    Delete only the selected code and data groups.

  3. Verify

    Check URL, port, containers, processes, volumes, and path.

  4. Reinstall

    Clone the official repository and follow active branch docs.

FAQ

Normally no. Ollama stores models separately; remove them only if no other tool needs them.

It normally keeps named volumes. The -v option requests volume deletion.

Yes, after stopping the app and backing up needed data outside it.

The official repository does not package a separate agent product; remove module configuration or the whole deployment.

Yes. Keep non-secret notes about ports, deployment method, and model endpoint.

Official sources

  1. Official Odysseus repository - Repository and branch structure checked July 19, 2026.
  2. Official setup guide - Docker and native setup paths.
  3. Docker Compose down reference - Container, network, image, and volume behavior.

Related guides

Verified July 19, 2026

Back to Odysseus AI Wiki