Skip to content

uninstalling.md

Latest commit

 

History

History
92 lines (65 loc) · 2.6 KB

uninstalling.md

File metadata and controls

92 lines (65 loc) · 2.6 KB
review-status needs-review
review-date 2025-06-04
reviewer migration-script
migration-notes Added during 2025 documentation reorganization

Uninstalling OpenSPP

This guide provides instructions for uninstalling OpenSPP from a Debian or Ubuntu system. It covers two main scenarios:

  • Complete Uninstallation: Removes the application, configuration, data, and database.
  • Partial Uninstallation: Removes the application but keeps your data and configuration for future use.

Before You Begin: Back Up Your Data

Warning: A complete uninstallation is irreversible and will permanently delete your data. Before proceeding, it is strongly recommended to create a full backup of your database and filestore.

For detailed backup instructions, refer to the {doc}database_management guide.

Complete Uninstallation

Follow these steps to completely remove OpenSPP and all its components from your system.

Step 1: Stop and Disable the OpenSPP Service

Stop and Disable (Remove) OpenSPP service

sudo systemctl stop openspp
sudo systemctl disable openspp

Step 2: Remove OpenSPP Package

Remove OpenSPP package and configuration files

sudo apt-get remove --purge openspp-17-daily
sudo rm -rf /etc/openspp
sudo rm -rf /var/lib/openspp
sudo rm -rf /var/log/openspp
sudo rm -f /usr/bin/openspp-server
sudo rm -f /usr/bin/openspp-shell

Step 3: Remove PostgreSQL Database (Optional)

Warning: This will permanently delete all OpenSPP data.

Drop the OpenSPP database and remove the user

sudo -u postgres dropdb name_of_your_db
sudo -u postgres dropuser openspp

Step 4: Remove Repository Configuration

Remove APT repository configuration and GPG Key

sudo rm -f /etc/apt/sources.list.d/openspp.list
sudo apt-key del "OpenSPP Repository"
sudo apt-get update

Step 5: Clean Up Dependencies (Optional)

If you want to remove PostgreSQL as well:

Remove PostgreSQL and its data and configuration

sudo apt-get remove --purge postgresql postgresql-client postgresql-common
sudo rm -rf /var/lib/postgresql
sudo rm -rf /etc/postgresql

Partial Uninstallation

If you want to keep the database but remove the application:

Stop, Disable(remove) service, and remove package

sudo systemctl stop openspp
sudo systemctl disable openspp
sudo apt-get remove openspp-17-daily
  • Keep database and filestore for potential reinstallation
  • var/lib/openspp/ and PostgreSQL database remain intact

Reinstall After Uninstallation

To reinstall OpenSPP after uninstallation, follow the {doc}../../getting_started/installation_deb.