--- title: "macOS full client" slug: "macos-full-client-v7-0" description: "Install the macOS full client with admin rights, enable auto-start, and manage IP tracking for seamless AppGate ZTNA access and log management." tags: ["Client Management", "macOS Full Client", "macOS Client"] updated: 2026-11-03T20:33:59Z published: 2026-11-03T20:33:59Z canonical: "support.appgate.com/macos-full-client-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. # macOS full client You can use the macOS full client on any user device, but installation requires administrator rights. When a user opens the `.dmg` file, the installer installs the full client with auto-start enabled. The full client supports auto-update, applied when the user initiates it. > [!NOTE] > NOTE > > To use the macOS client, turn off ***Limit IP address tracking*** on your device. If this setting is enabled, the client ignores DNS settings. You can disable it manually or through an Apple MDM profile. To disable it manually: > > 1. On your macOS device, go to **Settings > Network**. > 2. Select your ethernet connection or Wi-Fi. > 3. Select the **Details…** button. > 4. Disable ***Limit IP address tracking*** and select **OK**. --- ## Installing the macOS full client You can use the standard installer file for the macOS full client or manually install it with the command line. ### Downloading the installer from the command line To manually install **the latest version** of the client, run: ```bash curl -L -o "/tmp/AppGate-SDP-client.dmg" "https://bin.appgate-sdp.com/latest/macos/AppGate-SDP-client.dmg" ``` To install a specific version, run the following command and replace `x.y.z` and `x.y`with the correct version numbers: ```bash curl -L -o "/tmp/AppGate-SDP-client.dmg" "https://bin.appgate-sdp.com/x.y/client/Appgate-SDP-x.y.z-Installer.dmg" ``` To manually install the client, run the following command and replace `x.y.z` and `x.y` with the correct version numbers: ```bash curl -L -o "/tmp/AppGate-SDP-client.dmg" "https://bin.appgate-sdp.com/x.y/client/Appgate-SDP-x.y.z-Installer.dmg" ``` ### Installing the client from the command line Install the client with the following and replace `x.y.z` with the correct version number: ```bash hdiutil attach "/tmp/AppGate-SDP-x.y.z-Installer.dmg" -mountpoint /tmp/appgate sudo installer -pkg /tmp/appgate/Appgate\ SDP\ Installer.pkg -target "/" hdiutil detach /tmp/appgate ``` ## Using the command line to start the client When a user runs AppGate ZTNA by clicking it, the client launches. You can also pre-install the profile link at run time to avoid subsequent user interactions. To pre-install a client profile so users go straight to the sign-in form, run: ```bash /Applications/Appgate\ SDP.app/Contents/MacOS/Appgate\ SDP --url --novalidate ``` --- ## Configuring the macOS full client Run the following commands for each user account that will use the full client: #### Disable the data usage acceptance screen on first launch ```bash defaults write com.appgate.sdp.service user_approval -bool YES ``` #### Set the client profile URL Multiple profiles can be separated by semicolons: `"profile1;profile2"`. Replace `<full profile URL>` with the client profile link, found at the **Client Profiles** page (Identity > Client Profiles). ```bash defaults write com.appgate.sdp.service default_profiles " ``` 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.