# Telemt Panel

Control panel for Telemt MTProxy — **standalone** (direct `/v1`) or **fleet** (Go agents).

Image: `git.shts.su/denozord/telemtpanel`

## Quick start (standalone)

**Обязательно** задайте `JWT_SECRET` (≥ 8 символов) — без него контейнер не запустится.

```bash
docker pull git.shts.su/denozord/telemtpanel:latest
docker run -d --name telemt-panel --network host \
  -e PANEL_MODE=standalone \
  -e TELEMT_API_URL=http://127.0.0.1:9091 \
  -e JWT_SECRET="$(openssl rand -hex 32)" \
  -e BOOTSTRAP_USERNAME=admin \
  -e BOOTSTRAP_PASSWORD=change-me \
  -v /var/lib/telemt-panel:/data \
  git.shts.su/denozord/telemtpanel:latest
```

UI: `http://<IP-сервера>:8080` (логин `admin` / `BOOTSTRAP_PASSWORD`).

Полная инструкция (RU): **[docs/install.md](docs/install.md)**.

Также: [telemt-control-api.md](docs/telemt-control-api.md), [agent-protocol.md](docs/agent-protocol.md).

## Dev

```bash
pnpm install
pnpm --filter @telemt/db build && pnpm --filter @telemt/shared build
pnpm dev:api   # :8080
pnpm dev       # Vite :5173 → proxy /api
pnpm bootstrap-admin -- --username admin --password '…'
```

## Stack

- pnpm monorepo: `apps/web`, `apps/api`, `apps/agent`, `packages/{ui,db,shared}`
- Vite + React 19 + TanStack + Fastify + Drizzle/SQLite
- ReUI PRO (`surface: frame`) — [stats-12](https://reui.io/preview/base/stats-12), [auth-4](https://reui.io/preview/base/auth-4), [app-shell-12](https://reui.io/preview/base/app-shell-12)

## Compose

- `docker-compose.yml` — standalone (host network)
- `docker-compose.fleet.yml` — fleet control plane
- `deploy/docker-compose.traefik.yml` — prod за Traefik (`/opt/telemt-panel`)