> For the complete documentation index, see [llms.txt](https://hypercollector2.docs.hypersec.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hypercollector2.docs.hypersec.io/hypercollector-2-setup/manual-installation.md).

# Manual Installation

### APT <a href="#installing" id="installing"></a>

A HyperSec HyperCollector can be installed directly from the HyperSec APT Repository.

### Supported architectures <a href="#supported-architectures" id="supported-architectures"></a>

* x86\_64

### Data Drive Preparation <a href="#supported-architectures" id="supported-architectures"></a>

You should have an additional data drive attached to your system and mounted to /data/vector. If you are preparing a cloud-based HyperCollector (AWS, Azure) public cloud based encryption is assumed and to prep this data drive execute the following command (zipped). This will auto create and mount the data volume for local caching under /data/vector.&#x20;

{% file src="/files/RSdksy6NM2kLCHZQObIr" %}

This command may also present post installation in:

```
/opt/collector-core/bin/hs-prepdatadisks.sh
```

### Installation <a href="#installing" id="installing"></a>

* Add the HyperSec HyperCollector repo signing key:

{% code overflow="wrap" fullWidth="false" %}

```bash
curl -sSL https://<username>:<password>@apt.hypersecrepo.io/hypersec-2023-archive.gpg |  gpg -o /usr/share/keyrings/hypersec-2023-archive.pgp --batch --yes --dearmor
```

{% endcode %}

Note: If you have special characters in your password, you should % replace them . For example, replace # with %23.

* Add the HyperSec HyperCollector repo:

{% code overflow="wrap" %}

```bash
echo "deb [trusted=yes] https://<username>:<password>@apt.hypersecrepo.io/ jammy main" | tee /etc/apt/sources.list.d/collector.list
```

{% endcode %}

* Update the package index-files and update the base OS:

{% code overflow="wrap" %}

```bash
apt clean
apt update
apt upgrade -y 
```

{% endcode %}

* Install the HyperSec HyperCollector packages:

{% code overflow="wrap" %}

```bash
apt install -y --no-install-recommends collector-all
```

{% endcode %}

### Bootstrap Configuration <a href="#supported-architectures" id="supported-architectures"></a>

To initially configure the HyperSec HyperCollector to the default state apply the installation playbook to the system:

{% code overflow="wrap" %}

```bash
cd /opt/collector-core ; ansible-playbook ./install.yml
```

{% endcode %}

### Change Default Support User Password

<pre><code><strong>passwd support
</strong></code></pre>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://hypercollector2.docs.hypersec.io/hypercollector-2-setup/manual-installation.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.