> For the complete documentation index, see [llms.txt](https://docs.monarchlinux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.monarchlinux.com/basics/pentest-tools/pentestenv.md).

# PentestEnv

PentestEnv is Monarch’s native graphical manager for [Exegol](https://exegol.com/) and [RF Swift](https://rfswift.io/). Manage both engines from one window, open terminal sessions, and access environment workspaces and logs. Its colors follow your Noctalia theme.

## Meet the engines

### Exegol — a ready-to-use pentest toolbox

[Exegol](https://exegol.com/) provides maintained Docker environments with security tools already installed and configured. It suits general pentesting workflows, including network, web, and Active Directory assessments, as well as training and CTFs. Create a separate environment per engagement and keep its working files in a dedicated workspace, rather than installing every tool on your Monarch desktop.

PentestEnv manages Exegol containers and exposes common options such as resources, graphical applications, and shell logging. Exegol offers Community and paid plans; see its [official pricing and usage terms](https://exegol.com/pricing) to choose the appropriate plan.

For the shell customizations, additional tools, and first-start setup supplied by Monarch, see [Exegol](https://docs.monarchlinux.com/basics/pentest-tools/exegol.md).

### RF Swift — radio, wireless, and hardware toolboxes

[RF Swift](https://rfswift.io/) is developed by Penthertz for radio-frequency, wireless, and hardware work. Its ready-made toolboxes cover areas such as software-defined radio (SDR), Wi-Fi, Bluetooth, and RFID, with tools and dependencies packaged together. It is useful when a task needs specialized radio software or access to devices such as SDR receivers.

In PentestEnv, choose RF Swift to create and manage its containers alongside your Exegol environments. Image selection and hardware access depend on the job and connected equipment; the [RF Swift documentation](https://rfswift.io/docs/) covers device setup and advanced features.

**Which one should I choose?** Start with Exegol for general pentesting and with RF Swift for radio or hardware-focused work. You can install both and select the appropriate engine for each environment.

## Interface overview

![PentestEnv showing fictional Exegol and RF Swift environments, with demo-lab selected.](https://2401007956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPHuQxvjCbX3wVSeqqOGO%2Fuploads%2FnuY7F1CKjNMqjUoLesAe%2Fpentestenv-overview.png?alt=media)

*Demonstration data only: environment names and the home directory are fictional. The left pane lists environments from both engines; the right pane shows the selected environment, and the bottom bar provides its actions.*

## Install and launch

Install the application:

```bash
monarch install pentestenv
```

Install the engines you want to use separately:

```bash
monarch install exegol
monarch install rfswift
```

You can also install each component from **Monarch Menu → Install → Cyber → Pentest environments**: choose **PentestEnv**, **Exegol**, or **RF Swift**.

Launch **PentestEnv** from the application launcher or press **Ctrl+Alt+E**. Access to Docker may require authentication for the session.

## Create an environment

1. Click **Nouveau** or press **Ctrl+N**.
2. Choose **Exegol** or **RF Swift**, then select an image from the catalog.
3. Give the environment a name. Leave the workspace automatic or provide an existing directory using an absolute path.
4. Review the options offered for the selected engine and start creation. Follow the progress and any error messages in the application.

For Exegol, the application downloads the selected image when needed before creating and starting the container. Advanced options include networking, graphical applications, resources, desktop access, and shell logging. Enable logging when you need a record of terminal activity.

### Exegol access and images

The application displays your Exegol access tier. In Community mode, the selectable image is **free**. Use the license menu to manage activation or inspect an existing license; image availability depends on your Exegol access rights. PentestEnv does not include a paid Exegol subscription.

## Manage environments

Select an environment in the list to inspect its details and available actions. Use the buttons or these shortcuts:

* **Ctrl+N** — create an environment.
* **Ctrl+S** — start or stop the selected environment.
* **Ctrl+O** — open a terminal session in a running environment.
* **Ctrl+W** — open its workspace folder, when available.
* **Ctrl+L** — open its logs.
* **Ctrl+D** — open the deletion confirmation.
* **Up / Down** — select an environment.

Start a stopped environment before opening a terminal session. Check the selected environment before confirming deletion.

### Environment details

![Close-up of the fictional demo-lab environment: image, desktop, GUI, network, and workspace settings.](https://2401007956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPHuQxvjCbX3wVSeqqOGO%2Fuploads%2F2EiYrTIHy6qaHFPInojC%2Fpentestenv-details.webp?alt=media)

*Detail cropped from the demonstration screenshot above. The example workspace is `/home/demo/Envs/demo-lab`; your own path is shown in the application.*

## Workspaces and customization

Use the workspace path shown in the environment details to find its files on the host. A custom workspace can be selected during creation.

For Exegol’s default paths, shared resources, terminal customizations, and first-start behavior in Monarch, see the [Exegol guide](https://docs.monarchlinux.com/basics/pentest-tools/exegol.md). These customizations apply to Exegol containers, not RF Swift.

See the [PentestEnv project](https://github.com/monarch-os/monarch-pentestenv), [Exegol documentation](https://docs.exegol.com/), and [RF Swift documentation](https://rfswift.io/) for engine-specific configuration and advanced usage.
