Files
CLICD/docs/en/guide/installation.md
T
MengMengCode 38debab1aa Add custom image handling and access policy management
- Implement tests for custom KVM and LXC image creation, ensuring invalid sources and architecture mismatches are rejected.
- Introduce access policy management in CLI, allowing configuration of allowed sources and trusted proxies.
- Add NAT network configuration with validation for RFC1918 compliance and subnet parsing.
- Create panel access policy management, including normalization and evaluation of access decisions based on client IPs and forwarded headers.
- Develop middleware for enforcing access policies in the server, returning appropriate responses for allowed and denied requests.
- Enhance custom image downloading and validation, ensuring integrity and security of downloaded root filesystem archives.
- Include comprehensive tests for all new functionalities to ensure reliability and correctness.
2026-07-26 04:04:45 +08:00

1.8 KiB

Installation

CLICD provides a one-line installer. By default, it installs the latest version from GitHub Releases. You can also pin a specific version with an environment variable.

Requirements

  • Linux x86_64/amd64 or ARM64/aarch64 host.
  • Root privileges.
  • systemd.
  • Network access to GitHub Release downloads.
  • LXC runtime support if you want to use LXC.
  • KVM virtualization enabled with libvirt/QEMU installed if you want to use KVM.

Install the Latest Version

curl -fsSL https://raw.githubusercontent.com/MengMengCode/CLICD/main/install.sh | sudo sh

The installer asks for separate LXC and KVM NAT private subnets. Press Enter to scan host routes, interfaces, bridges, and libvirt networks and select non-overlapping RFC1918 /24 networks, or enter a CIDR such as 172.28.40.0/24. For unattended installation, set CLICD_LXC_SUBNET and CLICD_KVM_SUBNET.

The script defaults to CLICD_VERSION=latest and downloads clicd-linux-amd64.tar.gz or clicd-linux-arm64.tar.gz from releases/latest according to the host architecture.

Install a Specific Version

curl -fsSL https://raw.githubusercontent.com/MengMengCode/CLICD/main/install.sh | sudo CLICD_VERSION=v1.1.6 sh

Replace v1.1.6 with the release tag you want to install.

Open the Panel

After installation, open:

http://YOUR_SERVER_IP:8999

Use the administrator credentials printed by the installer for the first login. In production, restrict access at the firewall or reverse proxy layer and change the default username and password as soon as possible.

Uninstall

curl -fsSL https://raw.githubusercontent.com/MengMengCode/CLICD/main/install.sh | sudo sh -s -- uninstall

Before uninstalling, decide whether you need to keep containers, image cache, database files, or configuration files.