# Run pentest

1. To perform an automated pentest, the software component [Hacktor](/docs/manual/english/operation/platform/penetration-testing/hacktor.md) must first be installed in the corresponding network segment on a Linux system. For this select Environments → Hacktors → 'Add hacktor' (above right) and follow the instructions of the platform.
2. The second step is to define a [Target Group](/docs/manual/english/operation/platform/penetration-testing/target-groups.md). To create a Target Group, click on the menu item Target Groups under and on 'Add Target Group' in the upper right corner. Enter a name and a description. Click on 'Add Target Group' to save the Target Group.
3. In a third step, you use a [Audit Definiton](/docs/manual/english/operation/platform/penetration-testing/templates.md) to define which hacktor should attack which Target Group. For this purpose you select 'Create Template' under Templates in the upper right corner. Enter a name and a description. The option 'Recurring execution' allows you to plan future executions. Via 'Advanced Settings' you can switch on bruteforce tests. To add the template, click on the button 'Create Template'.
4. From the overview of the created templates, you can start the penetration test. Simply press 'Start scan'.
5. In the [Audit Report](/docs/manual/english/operation/platform/penetration-testing/audits.md) you can view the results of the pentest performed.

{% hint style="info" %}
We recommend initially pentesting 1-3 targets to optimally test Hacktor in your environment. With this small number of targets, you will receive detailed results after only 5-10 minutes and gain insight into how Hacktor works.
{% endhint %}

{% hint style="danger" %}
Please note that a pentest may temporarily affect the availability of your system! You are only allowed to perform a pentest on your own systems. Violations can result in legal consequences.
{% 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://docs.enginsight.com/docs/manual/english/operation/platform/penetration-testing/run-pentest.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.