安裝

在主機上跑一句指令，回答幾個問題，服務就起來了。

安裝地端版只要在主機上跑一句指令。它會自己檢查環境、下載需要的東西，中間問你幾個問題，跑完服務就起來了。拿到授權碼之後，照這一頁做。

需求

一台能跑 Docker Engine 24 以上的 Linux 主機（amd64 或 arm64）。macOS 上用 Colima、OrbStack 或 Docker Desktop 也可以。
最低 2 vCPU、4GB 記憶體；建議 4 vCPU、8GB。要裝文件解析服務再加 4GB。
磁碟最低 20GB，建議 100GB 以上。
不需要 GPU。模型另外部署，見本機服務與模型。

安裝指令只有一句，在你收到授權碼的那封通知裡。你需要一個能用 sudo 的帳號，在主機的終端機執行它。

雲端或地端，同一套產品示意圖

地端版裝在你的機房：安裝、授權、更新三件事都靠同一句指令與營運後台的授權頁。

curl -fsSL https://<服務站台>/install.sh | sudo bash -s -- --key DOTA-XXXXX-XXXXX-XXXXX

中間會問三個問題：
- 對外網址。同事登入用的就是這個網址。
- HTTPS 憑證來源：自動申請、內網自簽，或自備憑證。
- 要不要裝文件解析服務。知識庫要讀掃描 PDF、圖片、PowerPoint 與 Excel 時需要它。
跑完之後通知你的服務窗口，由我們遠端把模型、SMTP（寄信用的郵件伺服器）等設定好。

之後要更新版本，再跑一次同一句指令就是了。

選項	用途
`--url`	先把對外網址帶進去，就不會再問
`--dir`	改安裝目錄，預設 `/opt/dotagents`
`--yes`	全部用預設值，不問問題
`--uninstall`	移除服務，預設保留資料庫與上傳的檔案；加 `--purge` 連資料一起刪

選用的服務用 COMPOSE_PROFILES 打開：parser（文件解析）、search（網頁搜尋）、ops（營運後台的一鍵更新與啟動本機服務要靠它）、sandbox（程式執行沙盒）。

主機沒有對外網路

用映像 tar 檔安裝：由我們提供檔案，你在主機上 docker load 載入。授權也改用離線授權檔，見「授權」頁。

之後想在營運後台按「更新到

安裝時要開 ops 這個服務。沒開的話授權頁按不了，但會把要在主機上跑的指令顯示給你。