Wiki home

Uninstalling

One command:

sudo bash /opt/geekstream/installer/linux/install.sh --uninstall

It lists what is about to go, then asks you to type **remove everything** before it

touches anything. Nothing else will do; pressing return will not.

What it removes

- Your library, and everything GeekStream matched or downloaded

- Your owner account, and every setting and saved connection

- **The key your library is encrypted with**, so anything kept afterwards cannot be read

- All nine services and their data

- The server image, and the files in `/opt/geekstream`

That third one is worth reading twice. The encryption key lives only on this machine. A

copy of the library files made afterwards is not recoverable — not by you, not by us.

If you want your library, take a backup **first**; see

[Updates, backups and migration](updates-backups-migration.md).

What it keeps

**Your address.** Installing again gives you back the same

`yourname.geekstreammedia.net`, because the claim to it is kept.

**Docker**, and anything else on the machine. GeekStream does not remove software it did

not install.

**The firewall rule** for port 8790. It does nothing on its own — nothing is listening —

but you can remove it if you like.

Giving up your address too

sudo bash /opt/geekstream/installer/linux/install.sh --uninstall --forget-address

Do this only if you mean it. At present a released name is **not** returned to the pool,

so it stays claimed by an installation that no longer exists and you cannot take it again

yourself. If you simply want a different name, ask before uninstalling and it can be

changed for you.

Reinstalling afterwards

Exactly as the first time: unpack the download and run the installer. You will not be

asked for a name, because you still hold yours. Everything else starts empty — new owner

account, new keys, nothing kept.

See [Install and first setup](install-first-setup.md).

Removing it by hand

You should not need to, and it is easy to leave pieces behind. If the command will not

run, say what it did instead; that is a fault worth fixing rather than working around.