Cài đặt

Trang này hướng dẫn tất cả các phương pháp cài đặt Govard trên Linux và macOS.

QUAN TRỌNG

Không nên trộn lẫn các kênh cài đặt trên cùng một máy (ví dụ: .deb + make install + self-update ở các đường dẫn khác nhau). Chỉ sử dụng một kênh duy nhất để tránh xung đột binary trong /usr/bin và /usr/local/bin.

---

🚀 Cài đặt một dòng lệnh (Linux/macOS)

Cài đặt phiên bản release mới nhất bằng một lệnh duy nhất:

curl -fsSL https://raw.githubusercontent.com/ddtcorex/govard/master/install.sh | bash

Sử dụng wget:

wget -qO- https://raw.githubusercontent.com/ddtcorex/govard/master/install.sh | bash

Các tùy chọn cài đặt phổ biến

# Cài vào ~/.local/bin (không cần sudo)
curl -fsSL https://raw.githubusercontent.com/ddtcorex/govard/master/install.sh | bash -s -- --local

# Build từ source (tự động cài Go 1.25 nếu cần)
curl -fsSL https://raw.githubusercontent.com/ddtcorex/govard/master/install.sh | bash -s -- --source

# Chỉ cài CLI (bắt buộc với Ubuntu 20.04)
curl -fsSL https://raw.githubusercontent.com/ddtcorex/govard/master/install.sh | bash -s -- --cli-only

Mặc định, script sẽ cài govard (CLI) và, khi có WebKitGTK 4.1, cả govard-desktop (Desktop app) vào /usr/local/bin rồi:

• Tự động phát hiện và cài đặt system dependencies cần thiết.
• Khởi chạy các global services.
• Cấu hình SSL trust.
• Trên Linux, tự động fallback sang package .deb riêng của govard-desktop nếu archive độc lập không có sẵn trong bản release.

Ubuntu 20.04 không có WebKitGTK 4.1. Script sẽ tự nhận diện và chỉ cài CLI; dùng --cli-only để chủ động bỏ qua Desktop trên mọi nền tảng. Govard Desktop yêu cầu Ubuntu 22.04+ hoặc một bản Linux khác có WebKitGTK 4.1.

---

📦 Release Installers

Mỗi release được gắn tag đều publish hai package Linux riêng biệt.

Tải từ trang releases:

Linux (.deb)

Chỉ CLI (bao gồm Ubuntu 20.04):

sudo apt install ./govard_<version>_linux_<arch>.deb

CLI + Desktop (WebKitGTK 4.1 / Ubuntu 22.04+):

sudo apt install ./govard_<version>_linux_<arch>.deb ./govard-desktop_<version>_linux_<arch>.deb

Kênh package (Snap / CloudSmith)

# Snap (Linux, chỉ CLI — bắt buộc classic confinement vì
# Govard điều khiển Docker và ghi system paths)
sudo snap install govard --classic

# Debian/Ubuntu qua CloudSmith (setup repo một lần, rồi cài)
curl -1sLf https://dl.cloudsmith.io/public/ddtcorex/govard-deb/setup.deb.sh | sudo -E bash
sudo apt install govard

# Fedora/RHEL qua CloudSmith (setup repo một lần, rồi cài)
curl -1sLf https://dl.cloudsmith.io/public/ddtcorex/govard-rpm/setup.rpm.sh | sudo -E bash
sudo dnf install govard

# Alpine qua CloudSmith (setup repo một lần, rồi cài)
curl -1sLf https://dl.cloudsmith.io/public/ddtcorex/govard-apk/setup.alpine.sh | sudo -E bash
sudo apk add govard

macOS (.pkg)

sudo installer -pkg govard_<version>_Darwin_arm64.pkg -target /

---

🔧 Build từ Source

Điều kiện tiên quyết

Đảm bảo bạn đã cài đặt các công cụ sau:

Công cụ	Phiên bản yêu cầu
Go	1.25+
Node.js	20+
Yarn	v1.x
golangci-lint	v2.11+
Docker + Docker Compose	Bản mới nhất (chỉ cho lệnh stack — bản thân CLI không phụ thuộc Docker)
Wails	v2.11+ (chỉ khi phát triển desktop app)

Cài đặt từ Source

git clone https://github.com/ddtcorex/govard.git
cd govard
./install.sh --source

Thiết lập cho local development

1. Cài đặt Go 1.25+ từ go.dev

2. Kích hoạt Yarn qua Corepack:

   corepack enable

3. Cài đặt golangci-lint:

   curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin

4. Cài đặt Wails (để phát triển desktop):

   go install github.com/wailsapp/wails/v2/cmd/wails@latest
   wails version

Không cần quyền sudo — bạn có thể cài đặt mọi thứ ở local và cập nhật biến PATH.

---

🐳 Docker Images

Govard sử dụng một Dockerfile PHP duy nhất với build args thay vì các thư mục phân chia theo version.

# Image PHP tiêu chuẩn
docker build -f docker/php/Dockerfile \
  -t ddtcorex/govard-php:8.4 \
  --build-arg PHP_VERSION=8.4 \
  docker/php

# Image PHP tối ưu hóa riêng cho Magento 2
docker build -f docker/php/magento2/Dockerfile \
  -t ddtcorex/govard-php-magento2:8.4 \
  --build-arg PHP_VERSION=8.4 \
  docker/php

---

🖥️ Shell Completions

Release archives đóng gói sẵn scripts completion trong thư mục completion/, và package .deb tự cài chúng (bash, fish, zsh). Với các kênh cài khác, sinh từ binary:

govard completion bash > /etc/bash_completion.d/govard   # root
govard completion zsh > "${fpath[1]}/_govard"
govard completion fish > ~/.config/fish/completions/govard.fish
govard completion powershell | Out-String | Invoke-Expression

---

🔄 Cập nhật Govard

govard self-update

Lệnh self-update tự động tải về release artifact phù hợp với nền tảng, xác minh mã băm SHA-256 checksum, và thay thế các file binary đã cài đặt một cách atomic (govard + govard-desktop).

---

✅ Xác minh cài đặt

govard version
govard doctor

Lệnh govard doctor chạy các chẩn đoán hệ thống (system diagnostics) bao gồm kiểm tra Docker, DNS, ports và SSL trust store.

Các bản tải release (install.sh và npm) đều được xác minh sha256 với checksums.txt trước khi cài đặt; nếu hash không khớp, quá trình cài đặt dừng ngay. Không có flag bỏ qua bước kiểm tra này theo thiết kế.

---

← Trang chủ | Dự án đầu tiên →