# Install TgWitness for Telegram Chat Export

Canonical page: https://phishdestroy.io/tgwitness/docs/start/

Install TgWitness on Windows, Linux or macOS, connect a Telegram account and export a signed archive. Start with a fictional demo or your own workspace.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/llms.txt)

Install with one command, connect a Telegram account and choose what to save.

## Install on your computer

The installer includes Python and dependencies. Start with a chat export; add observation and investigation tools when you need them.

### Linux / macOS

```
curl -fsSL https://get.destroy.tools/install.sh | bash
```

### Windows · PowerShell / CMD

```
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
```

Ubuntu server: run as root. Desktop: run as your normal user.

Open the panel address shown by the installer and use its access key. Then connect your Telegram account. The panel key and your Telegram authorization are separate.

[Installation, signatures and updates](https://phishdestroy.io/tgwitness/docs/reference/installation/) explains the downloaded build, local access and server options. [Source and Docker instructions](https://phishdestroy.io/tgwitness/docs/reference/quickstart/) remain available.

## Choose your first task

1. [Connect an account](https://phishdestroy.io/tgwitness/docs/accounts/) by phone, QR or a supported session import.
2. Choose the chats, folder or account scope.
3. [Export the selected history](https://phishdestroy.io/tgwitness/docs/reference/account-export/), or start observation to retain future changes.
4. [Verify the archive](https://phishdestroy.io/tgwitness/docs/exports/) against a separately trusted key fingerprint.

## Use a temporary GitHub runner

[GitHub Actions capture](https://phishdestroy.io/tgwitness/docs/capture/) guides you through the fork, authorization, scope and archive password. Download the encrypted result and its workflow provenance after the run. No permanent collector server is needed for this workflow.

## Look around without an account

[Open the browser demo](https://phishdestroy.github.io/TgWitness/demo/?lang=en) to explore fictional messages, compare edits and inspect an export before installing anything.

![TgWitness conversation view with sample messages](https://phishdestroy.io/tgwitness/assets/chats-dark.png?v=684f81f890cc)

A sample workspace. Your own journal starts separately.

## Continue an investigation

For ongoing work, add the sources, file policies, search, reports and sharing permissions your case needs. [Start, scale and evidence](https://phishdestroy.io/tgwitness/docs/reference/overview/) explains the choices and published measurements.

For a server installation, follow [Keep it running](https://phishdestroy.io/tgwitness/docs/server/).
