Uninstalling Bibliogon¶
There are two ways to uninstall Bibliogon, depending on how you installed it.
Path A: Launcher (all platforms)¶
If you installed Bibliogon using one of the launchers (Windows, macOS, or Linux):
- Open the Bibliogon launcher.
- Click Uninstall.
- Confirm when prompted.
The launcher removes the installation directory and its own manifest. Docker volumes (your book data) are preserved by default.
If uninstall is interrupted (process killed, Docker locked files, power loss), the launcher writes cleanup.json at the start and marks each step as complete. On next launch, the launcher silently retries any step still marked incomplete.
To also remove Docker volumes and images, run the commands in the "What gets removed" section below.
Path B: Script (all platforms)¶
If you installed via install.sh or want a complete removal including Docker resources:
cd ~/bibliogon
bash uninstall.sh
The script asks for confirmation before removing anything. Type yes to proceed.
What gets removed¶
The uninstall script removes:
| Component | Location | Command |
|---|---|---|
| Docker containers | Running stack | docker compose -f docker-compose.prod.yml down |
| Docker volumes | Book data, database | docker volume ls --filter name=bibliogon -q \| xargs docker volume rm |
| Docker images | Backend + frontend images | docker images --filter reference='*bibliogon*' -q \| xargs docker image rm |
| Launcher manifest | Platform config dir | See below |
| Installation directory | ~/bibliogon (default) |
rm -rf ~/bibliogon |
Launcher manifest locations:
- Windows: %APPDATA%\bibliogon\install.json
- macOS: ~/Library/Application Support/bibliogon/install.json
- Linux: ~/.config/bibliogon/install.json
Keeping your data¶
If you want to keep your books before uninstalling:
- Open Bibliogon in the browser
- Go to the Dashboard
- Use Backup to export each book as a
.bgbfile - Save the
.bgbfiles somewhere safe - Then uninstall
After reinstalling, use Restore to import the .bgb files back.