# Installation  and activation guide

Control Pack is a Java desktop application. Because it runs on a JVM, it is multi-platform and can run on Windows, Linux or macOS. This guide explains how to prepare the environment and install Control Pack on your chosen OS.

***

### Overview & recommendations

* Control Pack requires a Java Virtual Machine (JVM). You can use [OpenJDK](https://openjdk.java.net/) and [Oracle Java](https://www.oracle.com/java/technologies/downloads/).
* Prefer a modern Java (JDK) release. For production and stability, we recommend using the latest **LTS** release.

***

### Environment suggestions

* We recommend running Control Pack from an isolated environment such as a virtual machine (VirtualBox, VMware, etc.).
* Control Pack includes exploit scripts and utilities that many antivirus products will flag (and in some cases quarantine or delete). Running from a VM reduces the risk to your primary desktop and prevents accidental leaks during testing.
* During penetration tests or red team exercises, always work from an isolated environment, not from your everyday workstation.

***

#### Nmap and Python

Control Pack requires both [Nmap](https://nmap.org/download.html) and [Python](https://www.python.org/downloads/) (V2.7). If you don't have them installed yet, you can either:

* Visit their official websites to download and install them manually.
* Simply launch Control Pack, and a pop-up will guide you through the installation process.

***

### Technical requirements

Minimum recommended resources:

* Disk: **≥ 500 MB** free
* RAM: **≈ 4 GB** or more
* CPU: modern multi-core CPU capable of handling multi-threaded workloads\
  Any operating system is suitable, provided a compatible JVM is installed.

***

#### Java installation: Quick notes <a href="#java-installation-quick-notes" id="java-installation-quick-notes"></a>

* Decide whether to use OpenJDK or Oracle JDK. Both are supported.
* Install a modern JDK. Preferably, the latest LTS release that receives long-term updates and support; using an up-to-date JDK gives you performance, stability and security improvements.
* After installing the JDK, verify it from a terminal/command prompt with `java -version` and `javac -version`. The output should match the JDK you installed.

{% hint style="success" %}
Install Java on Linux ( Debian-based ) or Mac:&#x20;

```
apt-get install default-jdk
```

```
brew install --cask oracle-jdk
```

{% endhint %}

***

#### Installation steps <a href="#installation-steps" id="installation-steps"></a>

​

{% embed url="<https://youtu.be/G_vWP8ATDQE?si=PRPGm1rOhfQLqsK4>" %}

* Download the launcher.
* Download your copy of Control Pack using the personal download link and the credentials provided. The download links and activation are available for **48 hours**.
* **Only** extract (uncompress) the launcher. Do **not** extract other archive files. It should look like this:

<figure><img src="https://1112023788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MU9W-baGw5TeUzNXoyo%2Fuploads%2FsCcUwaX61wqiBTgWJQ9F%2FScreenshot%202025-10-16%20115401.png?alt=media&#x26;token=53801abb-8c50-4b80-87d2-87c1cdfeccc7" alt=""><figcaption></figcaption></figure>

* Open the launcher .jar from the launcher folder.
* The tool in the launcher will appear greyed out.

<figure><img src="https://1112023788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MU9W-baGw5TeUzNXoyo%2Fuploads%2FVHIekiLpetU0JH67RWu0%2FScreenshot%202025-10-15%20121235.png?alt=media&#x26;token=2728dc1c-861d-4c65-a1b9-1977b5f870f5" alt=""><figcaption></figcaption></figure>

* Click **Activate**.
* In the file dialog, select the Control Pack `.zip` file you downloaded and click **Open**.
* Follow the on-screen steps. When activation succeeds, the **Order now** button will change to **Launch**.
* Click **Launch,** and a new window will open.

<figure><img src="https://1112023788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MU9W-baGw5TeUzNXoyo%2Fuploads%2FvGdIqlTjNetMYSDothg3%2FScreenshot%202025-10-16%20113511.png?alt=media&#x26;token=a251878c-5f9c-473e-8990-88cdfd2dbf08" alt=""><figcaption></figcaption></figure>

* Click **Browse key** and select your key file.
* Read the EULA carefully. If you agree, click **I agree**. Control Pack will then start.

Congratulations! You have used your first CPU cycles with Control Pack on your system! ‌

Happy Hacking!

#### Important notes <a href="#important-notes" id="important-notes"></a>

* If an antivirus flags files, run Control Pack in an isolated VM or lab and whitelist the Control Pack folder **only inside that isolated environment**.
* Do **not** run any of our tools as the Root/Administrator account. Run it as a regular (non-privileged) user to reduce risk.

***

{% hint style="warning" %}
The first time you run Control Pack, it will prompt you with the first-steps configuration wizard. If you need help to configure it in Control Pack, please check the section "[First Steps](https://app.gitbook.com/o/-MRg-J2g4LsQK3R8Mlro/s/-MU9W-baGw5TeUzNXoyo/master/first-steps)"

Never run Control Pack on production networks or systems without explicit authorisation.&#x20;

Keep your JVM and OS updated with security patches.

When performing client engagements, follow the rules of engagement and always get written authorisation.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://exploit-pack.gitbook.io/exploit-pack-manual-pages/control-pack/installation-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
