Saphan StudioDocs
Deployment

Uninstall

Each route removes what it put there, and none of them touch your identity, trust material, config or state.

First, the services — before the binaries

If this machine was set up to come back after a restart — the setup page does that by default once the machine is admitted — its supervisor holds units whose command lines name the very binaries the commands below delete. Remove the units first, or the supervisor is left starting a target that is gone, on every boot or login, with nothing left on disk to explain it:

saphan service status    --workspace <workspace>   # what is registered, and where
saphan service uninstall --workspace <workspace>   # stop them and remove the units

Machine-wide, both take --system, and uninstall needs sudo:

saphan service status         --system --workspace <workspace>
sudo saphan service uninstall --system --workspace <workspace>

Run it in the same scope the install used; each scope holds its own units, and services registered by another installation are never touched. See saphan service.

Then, the binaries

Per-user install:

rm -f ~/.saphan/bin/saphan ~/.saphan/bin/saphan-agent ~/.saphan/bin/saphan-gateway ~/.saphan/bin/saphan-server

Machine-wide install from the one-line installer:

sudo rm -f /opt/saphan/bin/saphan /opt/saphan/bin/saphan-agent /opt/saphan/bin/saphan-gateway /opt/saphan/bin/saphan-server

System-wide package:

sudo dpkg -r saphan # or: sudo rpm -e saphan

macOS self-extracting installer:

sudo rm -f /usr/local/bin/saphan /usr/local/bin/saphan-agent /usr/local/bin/saphan-gateway /usr/local/bin/saphan-server

A central server placed by hand (Central servers) is not removed by any of these, because no delivery route put it there. Stop it before you delete it — saphan-oauth by the SIGTERM its own document describes — and then remove the file wherever you put it.

Apart from the binaries, none of these touch ~/.saphan (or /opt/saphan) or your workspace — your identity, trust material, configuration and state survive an uninstall, and are yours to remove separately if that is what you want.

On this page