--- title: "Linux clients" slug: "linux-clients-v7-0" description: "Explore the differences between Full and Headless Linux clients, installation steps, configuration settings, and troubleshooting tips for optimal performance." tags: ["Client Management", "Linux Headless Client", "Linux Full Client", "Linux Client"] updated: 2026-10-31T16:52:22Z published: 2026-10-31T16:52:22Z canonical: "support.appgate.com/linux-clients-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. # Linux clients --- ## Client types There are two types of Linux client. For a quick overview of the differences, see the [Client compatibility matrix](/v1/docs/compatibilty-matrix-v7-0). The following table lists the Linux client types, the use each is designed for, and the installer filename pattern: | Type | Designed for | Filename pattern | | --- | --- | --- | | [***Full***](/v1/docs/linux-full-client-v7-0) | Normal enterprise usage, including pre-installation as part of standard builds. | `appgate-sdp_x.y.z_amd64...` | | [***Headless***](/v1/docs/linux-headless-client-v7-0) | Installation on unattended machines such as servers. | `appgate-sdp-headless_x.y.z...` | Confirm that the client version is compatible with the associated operating system version. See the [Downloads](/v1/docs/downloads) page. The full client is installed using the command line (or a desktop installer app) but is intended for use by a user in a desktop environment. The headless client is installed and configured to run as a service entirely using the command line --- ## Downloading the client See the [Downloads](/v1/docs/downloads) page, or use the commands found in the [full](/v1/docs/linux-full-client-v7-0) or [headless](/v1/docs/linux-headless-client-v7-0) articles. --- ## Installing and running the client There are separate installers for the [full](/v1/docs/linux-full-client-v7-0) and [headless](/v1/docs/linux-headless-client-v7-0) clients. See the article for each type for exact commands. --- ## Configuration settings Find client settings in `~/.config/appgatesdp-service`. In `~/.config/appgatesdp-service/user.settings`, find `<configuration><appSettings>` and: - To skip the data usage acceptance screen on first launch: `<add key="userApprovalPref" value="True" />` - To prevent device claim scripts from running (these run with full administrator privileges and present a security risk): `<add key="scriptsDisabledPref" value="True" />` The following table lists common configuration tasks: | Task | Details | | --- | --- | | **List local firewall rules** | `sudo iptables -L` Look for the `appgate-filter-input` and `appgate-filter-output` chains. | | **Clean all client settings** | `rm -rf ~/.config/appgate-ui ~/.config/appgatesdp-service ~/.local/share/appgatesdp-service` | | **Remove a profile link** | 1. Open GNOME Keyring (seahorse) or KWallet. 2. Look for `AppGate (Profile:123456etc)`. 3. Open the item and reveal the password to see the profile name. 4. Delete the required profile. | | **Remove all stored passwords and certificates** | 1. Open GNOME Keyring or KWallet. 2. Delete all entries containing “AppGate”. | ### DNS configuration The client includes a `set_dns` script that changes network configuration so that AppGate ZTNA domains use AppGate ZTNA DNS while regular DNS resolves everything else. It runs a local DNS resolver (`dnsmasq`) named `appgate-resolver`, or `systemd-resolved` if detected, and resets the network configuration on disconnect. The `set_dns` script requires: - `dnsmasq` - `dbus` - `systemd` as PID 1 This was tested against `network-manager` and `wicd`. Because the built-in script cannot cover every network configuration, you can write a custom script that uses the same command-line interface. For more information, run: ```bash /opt/appgate/linux/set_dns --help journalctl -u appgatedriver.service | grep set_dns ``` You can configure a custom script that uses the same command-line interface in `/etc/appgate.conf` to replace the built-in one. ### Troubleshooting If the network configuration is left in an incorrect state, restore it with the following: ```bash /opt/appgate/linux/set_dns --reset= chattr -i /etc/resolv.conf mv /etc/resolv.appgate /etc/resolv.conf ``` Then restart your network manager. --- ## Verifying package files AppGate signs Linux installer packages with GPG using the AppGate public key. Use the relevant tools for each distribution to verify package validity. The client installs the key at `/opt/appgate/appgate.gpg`. You can also download the key from `appgate.pub`. ### Fingerprint `F36B 319B CE07 48F7 7930 52E6 F600 207F 0680 FA29` ### Fedora Verification requires the `rpm` package, which RPM-based distributions install by default. Import the AppGate public key: ```bash sudo rpmkeys --import appgate.pub ``` If using the keyring installed with the client, export the key before importing: ```bash gpg --keyring /opt/appgate/appgate.gpg --export --armor > appgate.pub ``` Verify the package: ```bash rpmkeys --checksig PACKAGENAME ``` ### Ubuntu Install `dpkg-sig`: ```bash sudo apt install dpkg-sig ``` Import the AppGate public key: ```bash gpg --import appgate.pub ``` Or, if using the keyring installed with the client: ```bash gpg --import /opt/appgate/appgate.gpg ``` Verify the package: ```bash dpkg-sig --verify PACKAGENAME ```