# installation

{% hint style="info" %}
**Mục tiêu**: cài xong MIN Automate trên máy Windows, mở app thành công lần đầu.\
**Thời gian**: \~5 phút\
**Yêu cầu**: Windows 10/11 64-bit, có internet
{% endhint %}

## Bước 1 — Tải file cài đặt

1. Vào trang chủ chính thức: [https://minautomate.com](https://minautomate.com/) *(thay link thật)*
2. Nhấn nút **Tải về** ở header
3. Chọn phiên bản phù hợp:
   * **Installer** (`.exe`) — khuyến nghị, tự tạo shortcut + uninstaller
   * **Portable** (`.zip`) — không cài, giải nén chạy luôn; phù hợp ổ USB / máy không có quyền admin

## Bước 2 — Chạy installer

{% tabs %}
{% tab title="Installer (.exe)" %}

1. Double-click file `MIN-Automate-Setup-x.x.x.exe` vừa tải
2. Nếu Windows hỏi **"Do you want to allow\..."** → chọn **Yes**
3. Chọn thư mục cài đặt (mặc định `C:\Program Files\MIN Automate`)
4. Tick **Create desktop shortcut** nếu muốn shortcut ngoài desktop
5. Nhấn **Install** → đợi 30s-1 phút
6. Tick **Run MIN Automate** → **Finish**
   {% endtab %}

{% tab title="Portable (.zip)" %}

1. Giải nén file `.zip` vào thư mục bất kỳ (vd `D:\MIN-Automate\`)
2. Vào thư mục đó → double-click `MIN-Automate.exe`
3. Không cần cài đặt, app chạy ngay

{% hint style="warning" %}
**Portable mode**: dữ liệu lưu cùng folder app. Nếu di chuyển folder sang máy khác, mang theo cả thư mục là chạy được.
{% endhint %}
{% endtab %}
{% endtabs %}

## Bước 3 — Xử lý cảnh báo SmartScreen / Antivirus

Lần đầu chạy, Windows hoặc antivirus có thể hiện cảnh báo. **Đây là false positive** — MIN Automate KHÔNG chứa malware.

### Windows SmartScreen

Nếu thấy popup **"Windows protected your PC"**:

1. Nhấn **More info**
2. Nhấn **Run anyway**

### Antivirus (Avast, Kaspersky, Bitdefender…)

1. Mở antivirus → tìm mục **Exclusions** / **Whitelist** / **Trusted apps**
2. Thêm vào trắng:
   * Thư mục cài đặt MIN Automate (vd `C:\Program Files\MIN Automate\`)
   * File `MIN-Automate.exe`
3. Nếu antivirus đã **xóa** file → khôi phục từ **Quarantine** + add whitelist

{% hint style="warning" %}
**Tại sao bị nhận diện nhầm?** Automation tool có hành vi (gửi keystroke, đọc UI element) giống malware ở góc độ static analysis. Đây là vấn đề chung của TẤT CẢ automation tool, không riêng MIN Automate.
{% endhint %}

## Bước 4 — Mở app lần đầu

Sau khi cài xong:

1. Mở MIN Automate từ shortcut Desktop hoặc Start Menu
2. Lần đầu mở, app sẽ:
   * Tạo thư mục dữ liệu tại `%APPDATA%/.minautomate/` (installer) hoặc cùng folder exe (portable)
   * Khởi tạo database SQLite trống
   * Hiển thị màn hình **Kích hoạt license**

## Bước 5 — Kích hoạt license

Sau bước cài đặt, bạn cần kích hoạt license trước khi dùng được full tính năng.

{% content-ref url="/pages/44c1451003232193bad0f43e47824771f2abbd23" %}
[Broken mention](broken://pages/44c1451003232193bad0f43e47824771f2abbd23)
{% endcontent-ref %}

## Cài đặt xong, nhưng không mở được app?

### Lỗi: "WebView2 Runtime is missing"

* Tải và cài WebView2 Runtime: <https://developer.microsoft.com/microsoft-edge/webview2>
* Khởi động lại máy → mở lại MIN Automate

### Lỗi: ".NET Framework 4.8 is missing"

* Tải .NET Framework 4.8: <https://dotnet.microsoft.com/download/dotnet-framework/net48>

### App tự đóng ngay khi mở

* Mở **Event Viewer → Windows Logs → Application** → tìm log lỗi của `MIN-Automate.exe`
* Gửi screenshot log cho team support
* Tạm thời: thử chạy **Run as Administrator**

## Gỡ cài đặt (uninstall)

{% tabs %}
{% tab title="Installer" %}

1. Mở **Settings → Apps → Apps & features**
2. Tìm **MIN Automate** → nhấn **Uninstall**
3. Confirm → app bị gỡ

{% hint style="info" %}
**Dữ liệu**: uninstaller mặc định KHÔNG xóa `%APPDATA%/.minautomate/` (database + workflow). Muốn xóa hoàn toàn → xóa folder đó thủ công.
{% endhint %}
{% endtab %}

{% tab title="Portable" %}

1. Đóng MIN Automate
2. Xóa folder app đã giải nén
3. Xong (portable không để lại file rác ngoài folder)
   {% endtab %}
   {% endtabs %}

## Bước tiếp theo

{% content-ref url="/pages/44c1451003232193bad0f43e47824771f2abbd23" %}
[Broken mention](broken://pages/44c1451003232193bad0f43e47824771f2abbd23)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.minautomate.com/bat-dau/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.