--- title: "macOS always-on client" slug: "macos-always-on-client-v7-0" description: "Explore the always-on client, enabling secure remote connections and seamless user experience with headless and full modes for efficient device management." tags: ["Client Management", "macOS Always-On Client", "macOS Client"] updated: 2026-11-03T20:34:26Z published: 2026-11-03T20:34:26Z canonical: "support.appgate.com/macos-always-on-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 always-on client Always-on clients are similar to the full client that a normal user runs. They allow the user's device to connect to the network even when the user is not signed in. The always-on client combines the full client, which behaves in the usual interactive way, with the headless client, which runs in the background without a UI. Example use cases for the headless half of the always-on client: - [Provision entitlements](/v1/docs/configuring-entitlements-v7-0) sufficient to allow connection to the domain Controller. This can allow a computer to join a domain while remote from the network using only a bootable USB stick. - Include an entitlement (down rule) to allow remote administration of the device. - Set a [default route](/v1/docs/routing-client-traffic-v7-0) entitlement for the device so it captures and redirects all user traffic at all times. The only difference between this and the headless client is that the user can sign in because a screen and keyboard are available. Whenever the user is not signed in, the always-on headless client continuously tries to sign in; at boot, the device is always signed in through it, and the headless half receives its own entitlements based on its policy. This allows secure connections to a limited set of resources protected by AppGate ZTNA, regardless of what the user is doing. When the user signs in to the always-on full client, the headless half suspends, retaining its tokens in memory to resume later. When the user suspends the always-on full client or signs out, the always-on headless client takes over immediately. These two modes of operation are independent: renewing tokens for one does not renew tokens for the other. Auto-update, once initiated from either half, updates both parts together. > [!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**. --- ## System limitations The macOS always-on client has the following limitations: - Define different users for always-on headless and always-on full mode. Both clients must complete onboarding. If the same user has already onboarded in one mode, the other mode fails to onboard. The client consumes two user [licenses](/v1/docs/licenses-v7-0). - Multi-factor authentication (MFA) onboarding is not supported on the always-on headless client. If the always-on full client requires MFA, use a different identity provider (IdP) and two different profile links. - Custom on-demand device claims are not supported in always-on headless mode. - Define separate policies for always-on headless and always-on full modes, or use the `clientType` claim (reports `full` or `headless` depending on the active mode). --- ## Installing the macOS always-on client 1. Follow the same steps to [download and install](/v1/docs/macos-full-client-v7-0#installing-the-macos-full-client) as for the full client. 2. Pre-install a client profile to the [full client part of the always-on](/v1/docs/macos-full-client-v7-0#using-the-command-line-to-start-the-client) client. 3. [Configure the headless](/v1/docs/macos-headless-client-v7-0#installing-the-client-from-the-command-line1) part of the always-on client. --- ## Using the client See [macOS headless client.](/v1/docs/macos-headless-client-v7-0#using-the-client) ### Using the Service Configurator tool The `appgate_service_configurator` tool is in `/Library/Application Support/Appgate`. Enter: ```bash sudo /Library/Application Support/Appgate/appgate_service_configurator OPTION ``` The Configurator tool accepts the following options: | Option | Action | | --- | --- | | `getconfig` | Displays the current configuration. | | `reload` | Signs out and reconnects automatically. Useful for testing a new configuration. | | `status` | Gets the status of the running service. | The `status` option returns one of the following messages: | 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. | | `Connecting` | Client has successfully signed in and is connecting. | | `Connected` | Client is signed in and connected. Details of the entitlements, Gateways, and Sites are included. | | `Partially Connected` | Client is 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. | --- ## Uninstalling the macOS always-on client See [Uninstalling macOS clients](/v1/docs/macos-clients-v7-0#uninstalling-macos-clients). --- ## Logs See [macOS headless client](/v1/docs/macos-headless-client-v7-0#logs) and [macOS full client.](/v1/docs/macos-full-client-v7-0#logs)