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.debUbuntu ARM
sudo apt install ./appgate-sdp_x.y.z_arm64.debFedora
sudo dnf install ./appgate-sdp-x.y.z-fc41.x86_64.rpmRHEL
sudo dnf install epel-release
sudo rpm -i appgate-sdp-x.y.z-el9.x86_64.rpmChecking the installed version
To check the installed version, run:
appgate --versionStarting 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>" --novalidateFor 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.settingsSet the client profile link
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.settingsUninstalling the Linux full client
Use the command for your operating system:
Operating system | Install command |
|---|---|
Ubuntu |
|
Fedora |
|
RHEL9 |
|
Logs
Driver logs
View daemon logs using:
journalctl -u appgatedriver.serviceOr view logs in /var/log/appgate/driver.log
Client logs
Regular client logs are in ~/.appgate/log/ or use:
journalctl -t appgate-sdplog-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.