Timus Connect App for macOS® User Guide

The Timus Connect for macOS application allows your users to establish a secure, encrypted tunnel between their devices and your corporate network. It supports posture validation, policy enforcement, and ensures seamless access to protected resources across distributed environments.

Timus Connect is compatible with macOS 12.0 (Monterey) or later. Timus Connect Desktop 5.0.19 and above requires macOS 13.0 (Ventura) minimum.

You can download the installer from Manager → Settings → Agent Deployment → Downloads screen. Alternatively, users can access the same version from Timus My → Downloads screen.

When installing Timus Connect for the first time, the user account on the macOS device must have administrator privileges. Administrator rights are not required for future updates.

Installation & Sign-In Flow

To install Timus Connect on a user’s macOS device:

  1. Download the Installer
    Navigate to the Downloads in Timus My and select the latest macOS version.
  2. Launch the Application
    After installation, launch Timus Connect. The user must read and accept the End User License Agreement (EULA) before proceeding.
  3. Enter Timus Account Email
    The user must sign in via Timus My, then return to Timus Connect application.
    If the account is directory-synced (e.g., Microsoft Entra ID, Okta, Google Workspace), the user will redirect to the corresponding identity provider to complete sign-in.

Establishing a Connection

Once signed in, the user is directed to the Connect screen.

  1. Select a Gateway
    All gateways associated with the user’s authorized sites are listed here.
  2. Use the “Select Fastest” Option
    Automatically selects and connects to the gateway with the lowest latency.
  3. Connect
    Clicking Connect establishes the secure tunnel between the user’s device and the selected gateway.

Agent Settings

The Settings tab in the Timus Connect application allows to configure how the agent behaves on the user’s device. These configurations are managed through Agent Profiles in the Manager portal and can be optionally exposed for user-level control.

You can define and assign custom Agent Profiles to your users through the Manager portal. For more information, visit the Agent Profile Guide.

  1. VPN Protocol Selection

    Choose the tunnel protocol used to establish the connection:

    • WireGuard
    • Stealth WireGuard
    • OpenVPN

      If Smart Tunnel Protocol Fallback is enabled, the application will automatically attempt the alternative protocol if the selected one fails.

  2. Startup Behavior
    • Start on boot: Automatically launches the Timus Connect application when the user’s device starts.
    • Connect on application start: Automatically initiates a connection to the last used or default gateway upon launch.
  3. Network Optimization
    • Smart tunnel protocol fallback: Maintains high availability by switching protocols in case of failure.
    • Adaptive MTU adjustment: Dynamically adjusts the MTU to prevent packet fragmentation and optimize throughput.
    • Auto update: Keeps the agent up-to-date by silently applying the latest versions in the background.

Support Tools

The Support tab in the Timus Connect application provides essential tools for troubleshooting, diagnostics, and SSL certificate management.

  1. Install certificate

    Installs the required Timus SSL Root Certificate to the device. This enables:

    • Trusted communication with internal systems and gateways
    • Full functionality of features such as traffic inspection and secure tunnel setup
  2. Collect diagnostic logs
    Generates a compressed ZIP file containing system and agent logs. The user is prompted to select a location for saving the file. This file can then be sent to you or the Timus support team for investigation.
  3. Send test telemetry data:
    The telemetry data is collected in every 15 minutes. To fetch the current data, click this button to update the latest reported device signals.

Manual Certificate Installation

If SSL certificate installation fails or users encounter trust-related warnings:

  1. Open Keychain Access from Applications → Utilities.
  2. In the search bar, type the name of your SDN.
  3. Locate and double-click the corresponding certificate.
  4. Expand the Trust section and set When using this certificate to Always Trust.
  5. Close the window and enter your macOS password to confirm the changes.

If the issue persists, contact the Timus support team for assistance.

Silent Deployment

To deploy the Windows app silently using an RMM or scripting tool, refer to:

Go to Timus Connect for MacOS - Silent Deployment Script

Related to

Updated

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.