--- title: "Configurator tool" slug: "configurator-tool-v7-0" description: "Configure headless, always-on, and SSO clients with the AppGate Configurator tool. Manage settings, check status, and troubleshoot easily." tags: ["Windows Client", "Configurator Tool"] updated: 2026-10-31T16:51:07Z published: 2026-10-31T16:51:07Z canonical: "support.appgate.com/configurator-tool-v7-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.appgate.com/llms.txt > Use this file to discover all available pages before exploring further. # Configurator tool The Configurator tool is used to configure the headless, always-on, and SSO clients. The Windows Service *AppGate SDP Client Service* must be running to use this tool. After a complete configuration is applied, the client tries to sign in and continues to retry on failure. Apply a configuration at any time to force the client to try to connect. To run the Configurator tool: 1. Open a command prompt with administrator rights. 2. Go to the AppGate ZTNA installation location (default `C:\Program Files\Appgate SDP\Service\`). This folder contains the AppGate ZTNA Service executable. To list available commands, enter: `"Appgate SDP Service.exe" configurator --help` The Configurator tool uses the following options: | Option | Description | | --- | --- | | `get` | Gets information about the running service. | | `set` | Configures the service. | | `reset` | Resets the service. | | `--help` | Lists help options. | | `--version` | Lists version information. | --- ## Using the get command The `get` command returns the current configuration and active state of the service. Enter: `"Appgate SDP Service.exe" configurator get OPTION` The available options are: | Option | Description | | --- | --- | | `-c` or `--config` | Provides information about what is configured in the client. ![Current configuration settings for Appgate SDP service including controller URL and username.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag61-config_c.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A29%3A33Z&se=2026-11-21T22%3A29%3A33Z&sr=b&sp=r&sig=uQhsg2dPW2%2B2MKw2laYnf%2Fjrd4TYZn1Zcukrn1BFENU%3D) | | `-d` or `--details` | Shows the status with more details about Sites, Gateways, and entitlements. ![Command line output showing connection status and gateway information for Appgate SDP Service.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag61-config_d.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A29%3A33Z&se=2026-11-21T22%3A29%3A33Z&sr=b&sp=r&sig=HhtqBVBb1EM7sbmBDTxiNMdTsm1OI%2F6bDrZBFMF56H0%3D) | | `-s` or `--status` | Indicates whether the service is connected, still trying to sign in, or has encountered an error. If a new configuration is being applied, the following message may appear: [`STATUS] ` `Applying new config.` ![Command line output showing Appgate SDP Service status as connected.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag61-config_s.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A29%3A33Z&se=2026-11-21T22%3A29%3A33Z&sr=b&sp=r&sig=WjCnpH7mopc1DEtpDxpQBdnijcOtqtktKlCxdkQ7RgQ%3D)This indicates that a new configuration has been applied and the client will soon try to connect using it. | The connection status messages for the headless client are: | Status message | Description | | --- | --- | | Waiting for configuration | Client is waiting to be configured | | Applying the new configuration | Client is applying the configuration and trying to sign in to AppGate ZTNA. | | Connecting | Client has successfully signed in and is connecting. | | Connected | Client has successfully signed in and is connected to all Sites. | | Partially Connected | Client has successfully signed in but can only connect to some Sites. | | Suspended. Full client is currently connected (Always-on only) | Client is suspended because the full client is in operation. | | None connected | Client has successfully signed in but cannot connect to any Site. | | Disconnecting | Client is disconnecting and will soon try to sign in again. | --- ## Using the set command The `set` command configures the client. The profile link is required. Use the `-o` option in combination with additional options to configure credentials and other settings. Enter: `"Appgate SDP Service.exe" configurator set -o appgate://url.com OPTION OPTION` The available options are: | Option | Description | | --- | --- | | `-u` or `--username` | Sets the username for sign-in with credentials. Must be used with `-p`. | | `-p` or `--password` | Sets the password for sign-in with credentials. Must be used with `-u`. | | `-o` or `--profile` | Specifies the client profile link. Can be copied from Client Profiles (Identity > Client Profiles). | | `-a` or `--authenticationcertificatepath` | Sets the absolute path to the certificate PFX file for certificate authentication. | | `-b` or `--authenticationcertificatepassword` | Sets the password for the authentication certificate PFX file. | | `-m` or `--localcomputercertificatename` | Sets the subject name of the certificate in the local computer certificate store for certificate authentication. Enter any value to list available certificates. Overrides the P12/PFX file. | | `-l` or `--loglevel` | Sets the log level of the client. | See [LDAP Certificate IdP](/v1/docs/ldap-certificate-provider-v7-0) if using certificate authentication. The Configurator returns the following exit codes: - `0` — no error - `1` — error on the Configurator, including connection to the service or daemon. - `78` — Configurator completed successfully but the service or daemon returned errors, such as `success: false` - `127` — wrong or missing arguments --- ## Using the reset command The `reset` command resets the configuration or active state of the service. Enter: `"Appgate SDP Service.exe" configurator reset OPTION` The available options are: | Option | Description | | --- | --- | | `-c` or `--config` | Clears the current configuration of the client, even if connected. | | `-s` or `--service` | Resets the active state of the service, forcing it to reload the configuration and reconnect. | All `get`, `set`, and `reset` commands also include the following options: ![Command line options for enabling debug logging and displaying version information.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag62-get_set_reset.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A29%3A33Z&se=2026-11-21T22%3A29%3A33Z&sr=b&sp=r&sig=sRYamKgyYfKNT2OwQn51n%2FDqjmjKzOxPA2fqiDXNy00%3D) | Option | Description | | --- | --- | | `--JSON` | Displays command output in JSON format. Also prevents the process from blocking with "Press any key to continue." | | `--loglevel` | Sets the log level of the Configurator itself. | | `--help` | Lists help options. | | `--version` | Lists version information. | --- ### Log files location Configurator logs are in `C:\user\username\appdata\roaming\appgate\logs\configurator.log`.