7. Guardpot Agent Management7.2 Adding a Guardpot Agent to Guardpot Manager
πŸ“„7. Guardpot Agent Management

7.2 Adding a Guardpot Agent to Guardpot Manager

Updated 5 min read61 views

Prerequisites#

Before proceeding with adding a Guardpot Agent to Guardpot Manager, ensure that the following requirements are met:

  • Guardpot Manager has been successfully installed and its license has been activated.

  • Guardpot Agent has been installed on the target system.


7.2.1 Logging In to the Agent

Access the Guardpot Agent system using the following default credentials:

Default Credentials:

Field

Value

Username

guardpot

Password

Guardpot.123

Upon successful login, you will be greeted by the Guardpot Installer CLI screen, as shown in Figure 7.2.1-1.

GUARD
POT
Guardpot Installer  v1.5.10
Welcome to the Guardpot Installer.
This wizard will guide you through:
1.  Select a network interface
2.  Assign a static IP (optional VLAN on trunk)
3.  Configure Manager/hostname (mode-based)
4.  Set SSH management password
5.  Review & install
β†’ Press ENTER to begin...

Figure 7.2.1-1 – Guardpot Installer CLI Welcome Screen

Press Enter to proceed to the installation menu.


7.2.2 Selecting Installation Type

From the Select Installation Type menu, select option 1 – Standalone Guardpot to deploy a standard agent instance, as shown in Figure 7.2.2-1.

GUARD
POT
Guardpot Installer  v1.5.10
Select Installation Type
Choose one of the following installation modes:
[1] Standalone Guardpot
[2] Multi Guardpot (Pool)
[3] G-Hosts
β†’ Select installation type [1-3]: 1

Figure 7.2.2-1 – Installation Type Selection


7.2.3 Network Interface Selection

From the Enter Interface Number prompt, select the appropriate network interface for the agent, as shown in Figure 7.2.3-1. In this scenario, interface 1 is selected.

GUARD
POT
Guardpot Installer  v1.5.10
STEP 1 / 5 ── Network Interface
Select the network interface for Guardpot.
A static IP will be assigned to this interface.
#
Interface
State
MAC Address
Current IP
[1]
ens33
● UP
00:50:56:b6:fe:7f
192.168.1.10
β†’ Enter interface number [1-1]: 1

Figure 7.2.3-1 – Network Interface Selection


7.2.4 Static IP Address Assignment

Assign an available static IP address to the selected interface, as shown in Figure 7.2.4-1. In this scenario, 172.16.61.241 is used as the assigned IP address.

Note: Before proceeding, verify that the selected IP address is not currently in use on the network to avoid conflicts. Perform a ping test or consult your system administrator if necessary.

GUARD
POT
Guardpot Installer  v1.5.10
STEP 2 / 5 ── Static IP Configuration
Interface: ens33
Current IP: 192.168.1.10 (will be replaced)
Enter the static IP address for this machine.
Example: 192.168.1.100
β†’ IP Address: 172.16.61.241

Figure 7.2.4-1 – Static IP Address Assignment


7.2.5 Subnet, Gateway, and DNS Configuration

Enter the subnet prefix, gateway address, and DNS server address for the assigned interface. Once all values are provided, confirm the Apply This Configuration prompt to apply the network settings, as shown in Figure 7.2.5-1.

Guardpot Installer  v1.5.10
STEP 2 / 5 ── Static IP Configuration
Interface: ens33
Current IP: 192.168.1.10 (will be replaced)
Enter the static IP address for this machine.
Example: 192.168.1.100
β†’ IP Address: 172.16.61.241
Enter subnet prefix length.
Common values: 24 (255.255.255.0), 16 (255.255.0.0)
β†’ Subnet prefix [24]: 24
Enter the default gateway for this network.
Example: 192.168.1.1
β†’ Gateway: 172.16.61.1
Enter DNS server addresses.
β†’ DNS Server 1: 1.1.1.1
β†’ Add a second DNS server? [Y/n] n
Trunk port: ens33 (802.1Q tagged VLAN optional)
β†’ Configure VLAN on this trunk? [y/N] n
Network Summary
Interface  : ens33
IP Address: 172.16.61.241/24
Gateway    : 172.16.61.1
DNS        : 1.1.1.1
β†’ Apply this configuration? [y/n] y

Figure 7.2.5-1 – Network Configuration Confirmation


7.2.6 Manager & Hostname Configuration

The installer will present the STEP 3/5 – Manager & Hostname screen, as shown in Figure 7.2.6-1. Provide the following information:

Field

Description

Manager IP

The IP address of the Guardpot Manager instance (e.g., 172.16.61.222)

Manager Domain

The DNS record configured for Guardpot Manager (e.g., guardpot.local or company-name.guardpot.com)

Agent Hostname

The hostname that will be registered on Guardpot Manager for this agent

Once all fields are filled in, press Enter to continue.

Note: The Manager Domain must match the DNS record previously configured for the Guardpot Manager instance. This is typically guardpot.local for local deployments or a custom subdomain for enterprise environments.

GUARD
POT
Guardpot Installer  v1.5.10
STEP 3 / 5 ── Manager & Hostname
Enter the IP address of the Guardpot Manager server.
β†’ Manager IP: 172.16.61.218
♦ Manager IP: 172.16.61.218
Enter the domain of the Guardpot Manager server.
Example: techup.guardpot.com
β†’ Manager Domain: demo.guardpot.com
♦ Manager Domain: demo.guardpot.com
The hostname is sent to the Manager for identification.
Current hostname: guardpot-pool
β†’ Hostname [guardpot-pool]: guardpot-pool

Figure 7.2.6-1 – Manager & Hostname Configuration


7.2.7 SSH Password and Service Configuration

The installer will present the SSH Password Configuration screen, as shown in Figure 7.2.7-1. Enter a strong password for the SSH service. Subsequently, you will be prompted with Disable SSH Service? [Yes/No].

  • Select No to keep the SSH service enabled (used in this scenario).

  • Select Yes to disable SSH. If disabled, ensure the SSH port is changed from the default port 22 to an alternative port for security compliance.

In this scenario, the SSH service_Configuration_ is kept enabled and port 443220 is assigned.

GUARD
POT
Guardpot Installer  v1.5.10
STEP 4 / 5 ── SSH Password Configuration
Set the password for the guardpot system user.
This account is used for SSH management access.
β†’ Password:
β†’ Confirm :
♦ Password accepted
β†’ Disable SSH service? [y/N] n
Enter the SSH port number.
Default for Standalone: 44322
β†’ SSH Port [44322]: 44322

Figure 7.2.7-1 – SSH Password and Service Configuration


7.2.8 Configuration Summary and Completion

Review the Configuration Summary screen and enter Yes to confirm and finalize the installation, as shown in Figure 7.2.8-1.

GUARD
POT
Guardpot Installer  v1.5.10
STEP 5 / 5 ── Review & Install
Configuration Summary
Install Type : Standalone Guardpot
Interface    : ens33
IP Address  : 172.16.61.241/24
Gateway     : 172.16.61.1
Manager IP   : 172.16.61.218
Manager Dom. : demo.guardpot.com
Hostname    : guardpot-pool
SSH User    : guardpot
SSH Port    : 44322
β†’ Proceed with installation? [Y/n]

Figure 7.2.8-1– Configuration Summary


7.2.9 Verifying the Agent in Guardpot Manager

Once the installation is complete, navigate to the Guardpot Manager web interface. From the left-side navigation menu, click Guardpots to access the agent management view. The newly added Guardpot Agent will appear in the list as shown in Figure 7.2.9-1, confirming that the agent has been successfully registered with Guardpot Manager.

Figure 7.2.9-1 – Guardpot Agent Successfully Added to Guardpot Manager Configuration

Was this article helpful?

Your feedback helps us improve the documentation.

Still need help?

Our support engineers are one ticket away.

Send feedback by e-mail