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.