> For the complete documentation index, see [llms.txt](https://docs.telys.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telys.ai/operations/uninstalling.md).

# Uninstall

Remove the Telys package and, optionally, clear all on-disk state under \~/.telys.

Uninstalling has two parts: removing the `telys` package, and — for a clean slate — removing the on-disk state under `$TELYS_HOME` (`~/.telys` by default). Removing the package leaves your collections, credentials, and the installed runtime in place, so a later reinstall picks up where you left off. Removing `$TELYS_HOME` deletes all of that permanently.

{% hint style="danger" %}
`$TELYS_HOME` holds **your collections** along with cached credentials, the device key, and the runtime. Deleting it is irreversible — back up any collections you want to keep first.
{% endhint %}

## Uninstall steps

{% stepper %}
{% step %}

#### Remove the package

Use the tab matching your install method.

{% tabs %}
{% tab title="pipx" icon="terminal" %}

```bash
pipx uninstall telys
```

{% endtab %}

{% tab title="pip" icon="python" %}

```bash
pip uninstall telys
```

{% endtab %}
{% endtabs %}

This removes the `telys` command and the SDK. It does **not** touch `$TELYS_HOME`.
{% endstep %}

{% step %}

#### (Optional) Clear on-disk state

To remove every trace of Telys — collections, cached credentials, the device key, and the installed runtime — delete the state directory:

```bash
rm -rf ~/.telys
```

If you relocated state with `TELYS_HOME`, remove that path instead:

```bash
rm -rf "$TELYS_HOME"
```

{% endstep %}
{% endstepper %}

## Expected result

`telys` is no longer on your `PATH` — running it reports command not found:

```
$ telys version
zsh: command not found: telys
```

If you also removed `$TELYS_HOME`, the directory is gone:

```
$ ls ~/.telys
ls: /Users/you/.telys: No such file or directory
```

If you kept `$TELYS_HOME`, your collections and credentials remain, and a future `pipx install telys` finds them again.

{% hint style="info" %}
Unsure what `$TELYS_HOME` contains? See [On-disk layout](https://docs.telys.ai/operations/on-disk-layout.md) for the full file tree, and back up collections first with [Snapshots & persistence](https://docs.telys.ai/working-with-data/snapshots-and-persistence.md).
{% endhint %}

## Next steps

* [On-disk layout](https://docs.telys.ai/operations/on-disk-layout.md) — exactly what removing `~/.telys` deletes.
* Next: [Install Telys](https://docs.telys.ai/start-here/install.md) — reinstall whenever you are ready.
