# نصب

> نصب Meridian CLI در کامپیوتر محلی خود.

## نصب سریع

```
curl -sSf https://getmeridian.org/install.sh | bash
```

این اسکریپت:
1. اگر موجود نیست [uv](https://docs.astral.sh/uv/) را نصب می‌کند (یا pipx به عنوان fallback استفاده می‌کند)
2. `meridian-vpn` را از PyPI نصب می‌کند
3. یک symlink در `/usr/local/bin/meridian` برای دسترسی سراسری سیستم ایجاد می‌کند
4. از CLI قدیمی مبتنی بر bash (اگر موجود باشد) مهاجرت می‌کند

## نصب دستی

با uv (توصیه شده):
```
uv tool install meridian-vpn
```

با pipx:
```
pipx install meridian-vpn
```

## به‌روزرسانی

```
meridian update
```

Meridian به‌طور خودکار برای به‌روزرسانی‌ها بررسی می‌کند:
- **نسخه‌های وصله** (رفع اشکالات) — بدون سر و صدا نصب می‌شود
- **نسخه‌های جزئی** (ویژگی‌های جدید) — از شما خواسته می‌شود به‌روزرسانی کنید
- **نسخه‌های اصلی** (تغییرات شکاف‌دار) — از شما خواسته می‌شود به‌روزرسانی کنید

## نیازمندی‌ها

- **Python 3.10+** (توسط uv/pipx به‌طور خودکار نصب می‌شود)
- **دسترسی کلید SSH** به سرور هدف خود
- **qrencode** (اختیاری، برای کدهای QR ترمینال): `brew install qrencode` یا `apt install qrencode`

## تأیید نصب

```
meridian --version
```
