# Zactonz Git: Installation

> Deploy GitHub repositories to cPanel accounts automatically, with webhooks or a manual sync.

Page: https://developers.zactonz.com/cpanel-whm/zctzgit/installation/

Complete documentation for this product: https://developers.zactonz.com/cpanel-whm/zctzgit.md

The plugin ships as a `.tar.gz` archive containing the cPanel Jupiter interface files, the PHP backend, and `install.sh` / `uninstall.sh` scripts. Installation takes about a minute.

> Run every command on this page as `root`, over SSH or from **WHM › Terminal**.

## Quick install

```bash
cd /root && mkdir -p zctzgit && curl -fsSL https://github.com/zactonz/zctzgit/archive/refs/tags/v1.0.1.tar.gz | tar -xz -C zctzgit --strip-components=1 && cd zctzgit && bash install.sh
```

GitHub names its archives after the tag, so `--strip-components=1` puts the files straight into `zctzgit/` whichever version you download. Check [Releases](https://github.com/zactonz/zctzgit/releases) for the current tag.

The installer copies the plugin into cPanel's plugin directories, registers it with the Jupiter theme and prints a summary when it finishes.

## Step by step

1. **Download and extract the package** into the root home directory.

   ```bash
   cd /root
   mkdir -p zctzgit
   curl -fsSL https://github.com/zactonz/zctzgit/archive/refs/tags/v1.0.1.tar.gz | tar -xz -C zctzgit --strip-components=1
   cd zctzgit
   ```

2. **Run the installer.**

   ```bash
   bash install.sh
   ```

3. **Confirm the install.** Log in to any cPanel account and look for **Zactonz Git** under the **Files** group. If the icon does not appear straight away, have the user log out and back in so the theme cache refreshes.

## Updating

Run the quick-install command again with the new tag in the URL. The installer replaces the plugin files in place and clears files left by the previous version. Configured repositories live in each account's home directory and are kept.

Release notes for every version are on the [changelog](https://developers.zactonz.com/changelog/).

> **Upgrading from 1.0.0.** Version 1.0.0 contained syntax errors that stopped it running at all, so it holds no saved state to preserve. Install 1.0.1 straight over it.

## Uninstalling

From the extracted package directory:

```bash
bash uninstall.sh
```

This removes the plugin files and its cPanel registration. Cloned repositories inside account directories are left untouched.