安裝與啟動

何時用這份文件 你想第一次把 Argus 跑起來，不論是本機試用、做 PoC、還是內網部署的第一步。

前置條件

• 一個可用的 PostgreSQL 14+，用來當作 Argus 的 metastore
• 一個專用的 DB user / database（建議：argusdev / argusdev，dev 預設）
• 一台機器可以跑：
  • Docker 20.10+，或
  • Argus binary（Linux / macOS）

Argus 是單一二進位架構：一個 process、一個 Postgres、一個 HTTP port。

步驟

1. 準備 metastore

psql -U postgres <<SQL
CREATE USER argusdev WITH PASSWORD '<your-password>';
CREATE DATABASE argusdev OWNER argusdev;
SQL

不要把 Argus metastore 和你要管理的 production DB 放在同一個 cluster。

2. 啟動 Argus server

Binary

PG_URL=postgresql://argusdev:<your-password>@localhost/argusdev \
  ./argus --port 8080 --data ./argus-data

Docker

docker run --name argus -d --restart unless-stopped \
  -e PG_URL=postgresql://argusdev:<your-password>@host.docker.internal/argusdev \
  -v ./argus-data:/data \
  -p 8080:8080 \
  <your-registry>/argus:latest

3. 開瀏覽器

打開 http://localhost:8080。

第一次啟動會看到 建立 admin 帳號 畫面，填入：

• Login ID（主識別，例如 admin）
• Email（選填，但建議補）
• 密碼

這個 day-1 admin 帳號是 canonical 的；後續所有人員都可以由它建立。

詳細認證模型：認證模式（無 IdP day-1）。

驗證

curl -s http://localhost:8080/healthz
# {"status":"ok"}

UI 應該能登入；左側 sidebar 看到 Projects、Audit Log、Settings。

常見錯誤

症狀	原因	排除方式
pq: database "argusdev" does not exist	metastore 沒建好	重跑步驟 1
connection refused on :8080	port 已被占用	--port 8081
UI 一片白	static 沒打包	確認是用 release binary，不是 go run
Migration 失敗	metastore 的 Postgres 版本太舊	升級到 14+

下一步

• 接入第一個 instance：建立第一個 Instance
• 想了解設定項：Settings / 環境變數