Uninstall and reset
Remove Murage from Mac, Windows or Linux, find its data folders, start over with a clean slate, or run the setup again without losing anything.
Before you delete anything
- Take a backup if there's any chance you'll want your bots back: SettingsBackupsBack up now.
- Export teams you want to keep or share: +Export bots….
- Quit Murage fully, including from the menu bar or system tray, before you move or delete its folders.
Just want to run setup again?
You don't need to reset for that. SettingsGeneralGet set up runs the guided setup again. Your Chief of Staff picks it up where you left it, and everything already done stays done.
Uninstall the app
Mac: quit Murage, then drag Murage from Applications to the Trash.
Windows: open SettingsAppsInstalled apps, find Murage, and choose Uninstall.
Ubuntu .deb:
sudo apt remove murage
Ubuntu AppImage: delete the Murage.AppImage file.
Where your data lives
Murage keeps almost everything in one folder, .murage, in your home folder:
- Mac:
~/.murage(hidden; in Finder press Cmd+Shift+. to show it) - Windows:
C:\Users\you\.murage - Ubuntu:
~/.murage
It holds your settings, bots, conversations, memory, bot working folders, attachments and logs.
The desktop app also keeps a small app-data folder for window state, browser profiles and your encrypted keys. On Ubuntu it's ~/.config/murage. On Mac and Windows it's the Murage folder in your system's standard application data location.
These live elsewhere and aren't removed with Murage:
- Your backups and recovery key, in the folders you chose.
- Engines you installed, such as Claude Code or Codex, and their sign-ins.
- Local VM containers in Docker or Podman.
- Tailscale, if you installed it for phone access.
- Your Telegram bot, Slack app or Discord bot, which live in those services.
Remove everything
Step 1
Quit Murage
Quit Murage fully, including from the menu bar or system tray.
You're done when: Murage is not in the menu bar or system tray.
Step 2
Uninstall the app
Uninstall the app (above).
You're done when: the app is gone.
Step 3
Delete the data folders
- Delete the
.muragefolder. - Delete the app-data folder, if you want window state, browser profiles and saved keys gone too.
You're done when: the .murage folder is gone.
Step 4
Revoke what you connected (optional)
Delete your Telegram bot in BotFather, remove your Slack or Discord app, disconnect apps in Flux Router or in the account behind your own connected-apps key, and delete Local VM containers.
You're done when: nothing you connected is still linked.
Start fresh without losing the old setup
If you want a clean Murage but aren't sure you're done with the old one, don't delete: rename.
Step 1
Quit Murage
Quit Murage.
You're done when: Murage is closed.
Step 2
Rename the folder
Rename .murage to something like .murage-old.
You're done when: the folder is now called something like .murage-old.
Step 3
Open Murage
Open Murage. It starts as a new install.
You're done when: Murage starts as a new install.
To go back, quit Murage, delete the new .murage, and rename .murage-old back.
Saved keys are protected by your operating system and tied to the app, so a renamed folder may ask you to enter keys again when you switch back.
Restore on a new computer
Don't copy the .murage folder by hand between computers. Protected credentials don't move that way, and a copy taken while Murage is running can be inconsistent. Use SettingsBackups and Restore… instead, and keep your recovery key somewhere secure. See Backups and export.
Legacy folders
Very early builds stored data in a folder called .opengrokbot. Murage moves that data into .murage the first time it starts.