> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nagare.smtdfc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Cấu hình

> Biến môi trường và cấu trúc thư mục dữ liệu ~/.nagare của Nagare.

## Biến môi trường

### Gateway

| Biến | Mặc định | Mô tả |
| - | - | - |
| `NAGARE_GATEWAY_HOST` | `localhost` | Địa chỉ lắng nghe. `nagare gateway start --host` đặt biến này. |
| `NAGARE_GATEWAY_PORT` | `9832` | Cổng của REST API và WebSocket. |
| `NAGARE_GATEWAY_PUBLIC_KEY` | | Khóa công khai để xác minh token. `nagare gateway start` tự đặt từ keyring. |
| `NAGARE_GATEWAY_MODE` | | `nagare gateway start` đặt `prod`. Giá trị `debug` bật thêm `/metrics` và `/debug/pprof`. |

Plugin kế thừa toàn bộ môi trường của gateway. Ví dụ, plugin Telegram đọc `NAGARE_TELEGRAM_TOKEN`.

### Giao diện web và desktop

| Biến | Dùng bởi | Mô tả |
| - | - | - |
| `NAGARE_WEB_UI_PORT` | `nagare web` | Cổng giao diện web (mặc định `3005`). |
| `NAGARE_GATEWAY_URL` | `nagare web`, `nagare-desktop` | URL gateway. |
| `NAGARE_AUTH_TOKEN` | `nagare-desktop` | Token để đăng nhập tự động. |

### Plugin

Xem [Môi trường chạy plugin](https://docs.nagare.smtdfc.net/plugins/overview.md#moi-truong-chay).

## Thư mục dữ liệu

Mọi dữ liệu nằm trong `~/.nagare`:

```text theme={null}
~/.nagare/
├── .gateway.pid             # PID của gateway đang chạy
├── config.json
├── assets/                  # Giao diện web và gói plugin đi kèm
├── artifacts/               # Tệp do công cụ tạo ra (ví dụ ảnh chụp màn hình)
├── configs/
│   ├── plugins/<package>/   # Cấu hình riêng từng plugin
│   └── modules/
├── credentials/
├── data/
│   ├── plugins/<package>/   # Dữ liệu riêng từng plugin
│   └── modules/
├── databases/
│   └── nagare.db            # Cơ sở dữ liệu SQLite
├── logs/
│   ├── app.log              # Log của gateway
│   ├── plugins/<package>.log
│   └── modules/
├── modules/                 # Module, ví dụ nagare_vector
├── plugins/                 # Plugin đã cài
├── temp/
├── trusted/                 # Khóa công khai tin cậy để xác minh plugin
├── uploads/
├── nagare-plugin.sock       # Socket IPC cho plugin (Linux/macOS)
└── nagare-external-module.sock
```

Trên Windows, IPC dùng named pipe `\\.\pipe\nagare-plugin` và `\\.\pipe\nagare-external-module`.

## Khóa bảo mật

Cặp khóa RSA 4096-bit dùng để ký token được lưu trong keyring của hệ điều hành, dịch vụ `nagare.security.keyring`. Nó không nằm trong `~/.nagare`. Nếu bạn xóa khóa khỏi keyring, Nagare tạo khóa mới và mọi token cũ mất hiệu lực.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.