Linux full client

Prev Next

You can use the Linux full client on a normal user device, but installation requires administrator rights. It includes optional auto-start and remember-me functionality, so it connects the user automatically at boot without requiring interaction. The Linux client has partial support for auto-update.


Downloading the client

See the Downloads page, or use the following commands and replace x.y and x.y.z with the correct version numbers:

Ubuntu

curl -L -o "/tmp/AppGate-SDP-client.deb" "https://bin.appgate-sdp.com/x.y/client/appgate-sdp_x.y.z_amd64.deb"

Ubuntu ARM

curl -L -o "/tmp/AppGate-SDP-client.deb" "https://bin.appgate-sdp.com/x.y/client/appgate-sdp_x.y.z_arm64.deb"

Fedora

curl -L -o "/tmp/AppGate-SDP-client.rpm" "https://bin.appgate-sdp.com/x.y/client/appgate-sdp-x.y.z-fc41.x86_64.rpm"

RHEL

curl -L -o "/tmp/AppGate-SDP-client.deb" "https://bin.appgate-sdp.com/x.y/client/appgate-sdp-6.7.3-el9.x86_64.rpm"

Installing the Linux full client

Use the command for your operating system, replacing x.y.z with the correct version number:

Ubuntu

sudo apt install ./appgate-sdp_x.y.z_amd64.deb

Ubuntu ARM

sudo apt install ./appgate-sdp_x.y.z_arm64.deb

Fedora

sudo dnf install ./appgate-sdp-x.y.z-fc41.x86_64.rpm

RHEL

sudo dnf install epel-release
sudo rpm -i appgate-sdp-x.y.z-el9.x86_64.rpm

Checking the installed version

To check the installed version, run:

appgate --version

Starting the client

When a user runs AppGate ZTNA by clicking it, the client launches. You can also pre-install the profile link at launch time to remove subsequent user interactions. To pre-install a client profile so users reach the sign-in form, run the following and replace <full profile URL> with the client profile link:

/opt/appgate/Appgate\ SDP --url "<full profile URL>" --novalidate

For example: appgate --url appgate://controller.myco.com/profilename... --novalidate

Find the client profile link at Client Profiles (Identity > Client Profiles).


Client components

The Linux full client has the following components:

  • AppGate Service: The main client executable that runs in the background and handles all connections.

  • AppGate Driver: The virtual network adapter.


Configuring the Linux full client

Run the following commands for each user account that will use the full client:

Edit user settings

Go to ~/.config/appgatesdp-service/user.settings and find <configuration><appSettings>

Disable the data usage acceptance screen on first launch

sed -i 's|<add key="userApprovalPref".*/>|<add key="userApprovalPref" value="True" />|' ~/.config/appgatesdp-service/user.settings \
  || sed -i 's|</appSettings>|  <add key="userApprovalPref" value="True" />\n</appSettings>|' ~/.config/appgatesdp-service/user.settings

Multiple profiles can be separated by semicolons: "profile1;profile2"

sed -i 's|<add key="defaultProfilesPref".*/>|<add key="defaultProfilesPref" value="appgate://conn.example.com/fullclientprofile==" />|' ~/.config/appgatesdp-service/user.settings \
  || sed -i 's|</appSettings>|  <add key="defaultProfilesPref" value="appgate://conn.example.com/fullclientprofile==" />\n</appSettings>|' ~/.config/appgatesdp-service/user.settings

Uninstalling the Linux full client

Use the command for your operating system:

Operating system

Install command

Ubuntu

sudo apt remove appgate

Fedora

sudo dnf remove appgate

RHEL9

sudo dnf remove appgate


Logs

Driver logs

View daemon logs using:

journalctl -u appgatedriver.service

Or view logs in /var/log/appgate/driver.log

Client logs

Regular client logs are in ~/.appgate/log/ or use:

journalctl -t appgate-sdp
  • log- includes logs from the main service.

  • ui- includes logs from the UI process.

log-date and ui-date records are archived at the end of every day for 30 days.

Log level

To increase the log level, quit the client and run:

appgate --loglevel <value>

The <value> options are: Dump, Trace, Debug, Info, Warn, Error, Fatal

Info is the normal setting. Values to the right reduce the number of log records saved. Values to the left are not recommended unless AppGate support instructs you to use them.

To return to normal, quit the client and restart.