Files
ironclaw/docs/drafts/install/uninstalling.mdx
2026-04-09 14:18:30 +02:00

124 lines
2.2 KiB
Plaintext

---
title: Uninstalling IronClaw
sidebarTitle: Uninstalling
description: Completely remove IronClaw from your system
---
How to completely remove IronClaw from your system.
## Stop IronClaw
```bash
# If running in terminal
Ctrl+C
# If running as a service
sudo systemctl stop ironclaw # systemd
brew services stop ironclaw # Homebrew
```
## Remove Binary
<Tabs>
<Tab title="Linux/macOS">
```bash
# Remove binary
rm ~/.local/bin/ironclaw
# Or if installed system-wide
sudo rm /usr/local/bin/ironclaw
```
</Tab>
<Tab title="Ubuntu/Debian (APT)">
```bash
sudo apt remove ironclaw
sudo apt autoremove
```
</Tab>
<Tab title="macOS (Homebrew)">
```bash
brew uninstall ironclaw
brew untap ironclaw-ai/tap
```
</Tab>
<Tab title="Docker">
```bash
# Stop and remove container
docker stop ironclaw
docker rm ironclaw
# Remove image
docker rmi nearai/ironclaw:latest
```
</Tab>
</Tabs>
## Remove Data
<Warning>
This permanently deletes all IronClaw data including conversations, memory, and settings. This cannot be undone.
</Warning>
```bash
# Remove data directory
rm -rf ~/.ironclaw
# Remove service files
sudo rm -f /etc/systemd/system/ironclaw.service
sudo systemctl daemon-reload
# Remove launchd service (macOS)
rm -f ~/Library/LaunchAgents/ai.ironclaw.service.plist
# Remove logs
sudo rm -rf /var/log/ironclaw
```
## Remove PostgreSQL Database
If you used PostgreSQL:
```bash
# Remove database (optional)
sudo -u postgres psql <<EOF
DROP DATABASE ironclaw;
DROP USER ironclaw;
EOF
```
## Verify Removal
```bash
# Check binary removed
which ironclaw
# Should return nothing
# Check data removed
ls -la ~/.ironclaw
# Should return: No such file or directory
# Check service removed
sudo systemctl status ironclaw
# Should return: Unit ironclaw.service could not be found
```
## Partial Removal
To keep your data but remove the binary:
```bash
# Just remove binary
rm ~/.local/bin/ironclaw
# Data remains at ~/.ironclaw/
# Reinstall later and your data will be intact
```
## Next Steps
- [Install IronClaw](/install) again if needed
- Your data can be restored if you kept `~/.ironclaw/`