Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation

Solutions

Featured solutions AI Campus and branch Data center WAN Security Service provider Cloud operator Industries
Campus and Branch

Welcome to the NOW Way to Wi-Fi

Take your networking performance to new heights with a modern, cloud-native, AI-Native architecture. Only Juniper can help you unleash the full potential of Wi-Fi 7 with our AI-Native platform for innovation.
Prepare for liftoff
Business intelligence analyst dashboard on virtual screen. Big data Graphs Charts.

AI Data Center Networking

Juniper’s AI data center solution is a quick way to deploy high performing AI training and inference networks that are the most flexible to design and easiest to manage with limited IT resources.
Find out more
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Zero trust security

Ops4AI Lab

Visit our lab in Sunnyvale, CA and see our AI data center solution for yourself. You can try out your own model’s functionality and performance, too.
Visit the lab
Enterprise AI-Native Networking

Enterprise AI‑Native Routing

Juniper's Ai-Native routing solution delivers robust 400GbE and 800GbE capabilities for unmatched performance, reliability, and sustainability at scale.
Explore enterprise routing
Higher Education

Shaping Student Experiences: The NOW Way to Build Higher Education Networks

Juniper Networks CIO Sharon Mandell and a virtual summit of C-level IT leaders from prestigious institutions discuss ongoing efforts to support digital transformation on campus.
Watch now
Hand on tablet with healthcare overlay of graphics

Security in healthcare

In this IDC Spotlight report, discover how AI networking can automate and strengthen a healthcare ecosystem to defeat criminals and prevent loss. 
Gain insights into ecosystem security
Retail

The Future of In-Store Technologies

Retail experts Kevin McCartan, Senior IT Service Delivery Engineer at Musgrave; Jack Stratten of Insider Trends; and Christian Gilby, Senior Director of Product Marketing at Juniper Networks, discuss customer experiences.
See the future

Products

Wireless access Wired access SD-WAN / SASE Routing and switching Security Mist AI™ Management software Network operating system Blueprint for AI-Native Acceleration Optics
  • Operations
ACX7020 router

Juniper ACX7020 Cloud Metro Access Router

Legacy networks simply cannot meet the demands of today’s rapidly evolving metro landscape. Unlock a new generation of highly scalable architectures and automated operations with the Juniper ACX7020. 
Learn more
EX4000 Ethernet Switch

Next-gen AI-Native EX4000 line of switches

Lack of AI innovation from your current networking vendor slowing you down? Embrace Juniper’s cloud-native, AI-Native access switches that support every level and layer, across nearly every deployment.
Discover how
The Q and AI text with an image of Bob Friday and Kedar Dhuru.

The Q&AI Podcast

Delivering practical solutions and enriching discussions, this podcast series is a vital resource for those seeking an in-depth exploration of AI's transformative potential.
Catch the latest episode

Services

Services
Services AI Care

Juniper AI Care Services Revolutionize Your Service Experience

Our industry-first AI-Native services couple AIOps with our deep expertise across the full network life cycle. You can move from reactive response to proactive insight and action.
Explore AI Care Services
Services AI Data Center

Juniper AI Data Center Deployment Services Optimize Your AI Model Runs

We use our expertise and validated designs to help design, deploy, validate and tune networks, including GPUs and storage, to get the most from your AI infrastructure operation.
Learn about AI Data Center Deployment Services

Partners

Partners

Support and Documentation

Support and Documentation

Learn

About Juniper Training Events The Feed Resources Technology learning topics Thought leadership and insights
Audience raising hands up while businessman is speaking in training at the office.

Juniper certification and training news

See the latest
Ringing of the bell

All global events

See the latest
AI-native-now

AI-Native NOW event series

Explore events
AINN AI Innovation Impact Virtual Event

AI-Native NOW: AI Innovation and Impact

Register NOW
Juniper's Christina Hendrix at the head of a conference table. With the text "The NOW Way to Network" overlayed, with "NOW" emphasizing the "O" in green color.

The NOW Way to Network

Watch the video series
AI Native Now

Executive insights

Dive deep with leading experts and thought leaders on all the topics that matter most to your business, from AI to network security to driving rapid, relevant transformation for your business.
Learn more
A keynote speaker giving a presentation at a conference. There are dozens of people sitting around them. The presentation is displayed via projector on all the walls in the room.

Leadership voices

Juniper Networks’ leaders operate on the front lines of creating the network of the future. Take a look around to see what’s on their minds.
Watch now
Bob Friday and Jessica Garrison speaking

Bob Friday Talks

Join Bob as he ventures into all the knowns -- and -- unknowns -- of AI.
Catch the latest episode
Documentation
Menu
License Guide
Quick Starts
Validated Designs
Home Documentation Mist AI Operations Juniper Mist AI-Native Operations Guide Marvis Client

Juniper Mist AI-Native Operations Guide

keyboard_arrow_up
close
keyboard_arrow_left
Juniper Mist AI-Native Operations Guide
Table of Contents Expand all
list Table of Contents

Marvis macOS Client

date_range 21-Feb-25
arrow_backward
arrow_forward

Complete the preinstallation tasks, and then choose the method that you want to use to install the Marvis client on your macOS device.

The Marvis client for macOS provides detailed visibility into how your macOS device interacts with the wireless network. With insights into device connectivity and performance, the Marvis client helps optimize network performance, streamline troubleshooting, and enhance overall user experience.

Marvis macOS Client Installation Overview

You can download the installer file from the Juniper Mist portal. To download the installer file from the Juniper Mist portal:

  1. Select Organization > Admin > Mobile SDK from the left menu.

  2. Click Marvis Client at the top of the Mobile SDK page.

  3. Under MacOS, select the app version, and then click Download Installer.

    You'll need to save the *.dmg installer file in a folder on your device.

Prerequisites

Before you begin, you'll need:

  • The secret token to onboard your Marvis client

    To obtain the secret code:

    1. Select Organization > Admin > Mobile SDK from the left menu on the Juniper Mist portal.

    2. Click Token at the top of the Mobile SDK page.

    3. Create a new token, or use an existing token:

      • For a new token—Click Create Invitation. Enter a name for this invitation, and then click Create. When the token appears on the page, click View to see the QR code.

      • For an existing token—Refer to the token names to find the one that you want to use. Click the View link on the right side of the page to see the QR code.

      Note: To obtain the secret token using API, see https://api.mist.com/api/v1/docs/Org#sdk-invite.

  • macOS 12 or a later release running on your device

  • Administrator rights required for installation

Installation Options for the Marvis Client (macOS)

You can install the Marvis client for macOS by using any of the following methods:

Operational Modes

The Marvis client operates in the following modes:

  • Production mode—Standard operational mode for live environments that you can set using command-line parameters during installation.

  • Proof of Concept (POC) mode—Operational mode for testing and evaluation purposes and is also the default mode.

  • GUI or Non-GUI mode—Mode that enables or restricts visual access to the Marvis client. In non-GUI mode, you cannot access the user interface or the Marvis client icon in the taskbar.

  • Debug mode—Mode to access the logs. You cannot edit the configuration in this mode.

Note:

  • If you want to view the configuration settings when you're in Production mode, you'll need to switch to debug mode. However, the settings are not editable.

  • In POC mode, you can view and edit the configuration settings without any dependency on the debug mode.

Connection States

The Marvis client status is indicated by the following visual indicators and connection states:

  •  Disconnected—Client is not connected to the Juniper Mist cloud.

  •  Connected—Client is connected to the Juniper Mist cloud.

  •  Connecting—Client is requesting to connect to the Juniper Mist cloud.

  •  Sleeping —Client is connected to the Juniper Mist cloud through a non-Juniper AP.

Install the Marvis Client for macOS (CLI Method)

To install the Marvis client for macOS using the CLI:

  1. Extract the .pkg file from the .dmg file.
  2. Press the Command + Space keys to open the Spotlight search window.
  3. Type Terminal. The Terminal app is displayed in the search results.
  4. Double-click the Terminal app.
  5. Execute the following command:
    content_copy zoom_out_map
    sudo installer –pkg <path_to_pkg> -target / && /Applications/Mist/startMarvisClient.sh --token-value <token_value> --production-mode <true|false> --ui-mode-enabled <true|false>

    Set the values for:

    • token_value (required)—Provide the secret token.

    • mist_ui_enabled (optional)—Set the value to false if you want to hide the UI.

    • production_mode (optional)—Set the operational mode. The visibility of features in the Marvis Client UI depends on the operational mode:

      • True: Indicates Production mode, which is the standard operational mode for live environments.

      • False (default): Indicates Proof of Concept (POC) mode for testing and evaluation purposes.

  6. Enter the administrator password when prompted.
  7. Enable location services:

    1. Navigate to System Settings > Privacy & Security > Location Services.

    2. Enable location services for MarvisClient.

  8. Verify that the installation is successful. See Verify the Installation.

Install the Marvis Client for macOS (GUI Method)

To install the Marvis client for macOS:

  1. Double-click the .dmg file and then double-click the .pkg file to start the installation process.
  2. Click Continue.
  3. Click Install.
  4. Enable location services:

    1. Navigate to System Settings > Privacy > Location Services.

    2. Enable location services for the MarvisClient.

  5. Press the Command + Space keys to open the Spotlight search window.
  6. Type Terminal.
    The Terminal app is displayed in the search results.
  7. Double-click the Terminal app.
  8. Execute the following command:
    content_copy zoom_out_map
    /Applications/Mist/startMarvisClient.sh --token-value <token_value> --production-mode <true|false> --ui-mode-enabled <true|false>

    Set the values for:

    • token_value (required)—Provide the secret token.

    • mist_ui_enabled (optional)—Set the value to false if you want to hide the UI.

    production_mode (optional)—Set the operational mode. The visibility of features in the Marvis Client UI depends on the operational mode:

    • True: Indicates Production mode, which is the standard operational mode for live environments.

    • False (default): Indicates Proof of Concept (POC) mode for testing and evaluation purposes.

  9. Verify that the installation is successful. See Verify the Installation.

    After the installation is complete, you'll see the Marvis icon in the status bar.

  10. Click the hamburger icon and select Configuration.
  11. Enter the SDK token in the Mobile SDK Secret field and click Apply.

    By default, the Battery Saving mode is set to Standard and you can change the mode if required. This mode determines the frequency at which the payloads are sent.

    • High: In this mode, the client sends data payloads every 2 minutes. With reduced frequency of data transmission, this mode helps conserve battery power. This mode is suitable for scenarios that require less frequent updates.

    • Standard: In this mode, the client sends data payloads every 30 seconds. This mode provides a balance between data and battery consumption, offering more frequent updates without significantly impacting battery life.

    • Low: This mode provides the highest frequency of data transmission by sending data payloads every 10 seconds. This mode provides the most detailed insights into network performance but consumes more battery power compared to the other modes.

Deploy the Marvis Client on macOS Devices Using an MDM

You can deploy the Marvis client on macOS devices by using the SOTI, Intune, or Jamf mobile device management (MDM) solution.

To deploy the Marvis client:

  1. Enroll the target devices or device groups with the appropriate MDM profile.

  2. Configure the necessary profiles or application policies within your MDM portal.

  3. Upload the Marvis client .pkg installer file to your MDM portal and assign the file to the target devices or device groups.

  4. After the installation is complete, send a configuration script to the devices through the MDM portal:

    content_copy zoom_out_map
    /Applications/Mist/startMarvisClient.sh --token-value <token_value> [--production-mode <true|false>] [--ui-mode-enabled <true|false>]

    You will be prompted to allow Location Services for the Marvis client. You must select Allow, as the permission is necessary for the application to function correctly.

Upgrade the Marvis Client for macOS Using MDM

To upgrade to a newer version of the Marvis client, upload the updated .pkg file to the MDM portal and reassign the application policies to the target devices or device groups. You need not resend the configuration script.

Update the Marvis Client Configuration for macOS Using MDM

To update the Marvis client configuration parameters, resend the configuration script with the updated parameters:

content_copy zoom_out_map
/Applications/Mist/startMarvisClient.sh --token-value <token_value> [--production-mode <true|false>] [--ui-mode-enabled <true|false>]

Uninstall Marvis Client for macOS Using an MDM

To uninstall the Marvis using an MDM:

  1. Remove the application policy assignment if it enforces mandatory app installation.

  2. Send the uninstallation script to the devices:

    content_copy zoom_out_map
    /Applications/Mist/uninstall.sh

    You might still see the app as Installed on some MDM portals. After you remove the policy, wait for a while, and then check the app status.

    Note:

    The uninstall process might not remove all log files and folders. You can choose to delete the files manually if required. To completely remove Marvis client along with all the logs and configuration files, use the following command:

    content_copy zoom_out_map
    /Applications/Mist/uninstall.sh --clean

Verify the Installation

Use any of the following options to verify that the Marvis client was installed successfully:

  • Verify that the Mist folder is present in your Applications directory.

  • Verify the background services:

    1. Open the Terminal app and execute the following command:

      content_copy zoom_out_map
      sudo launchctl list | grep mist

    2. Provide your administrator password when prompted.

    3. Verify that a service entry (for example, 819 0 com.mist.MarvisClient) is present.

  • Verify that MarvisClient is listed in the Services tab in Activity Monitor.

    If you do not see MarvisClient listed, reinstall the Marvis client. If that does not resolve the issue, contact the support team.

After the installation, you’ll see the Marvis icon in your system tray or menu bar. You can click the icon to open the Marvis client and view the connection status.

Manage Services

Here are the commands that you can use to manage the Marvis client services:

  • Stop services:

    content_copy zoom_out_map
    launchctl stop com.mist.MarvisClient

launchctl unload /Library/LaunchDaemons/com.mist.MarvisClient.plist && pkill -x MarvisClient

  • Start services:

    content_copy zoom_out_map
    launchctl load /Library/LaunchDaemons/com.mist.MarvisClient.plist

launchctl start com.mist.MarvisClient

  • Restart services:

    content_copy zoom_out_map
    launchctl unload /Library/LaunchDaemons/com.mist.MarvisClient.plist && pkill -x MarvisClient

launchctl load /Library/LaunchDaemons/com.mist.MarvisClient.plist

launchctl start com.mist.MarvisClient

View Logs in the Marvis macOS Client

The Marvis macOS client classifies the logs as:

  • Info—General information

  • Error—Critical issues

  • Debug—Detailed data that you can use to debug issues

To view the logs in the Marvis macOS client, you'll need to enable debug mode:
  1. Click the hamburger icon and then click the Marvis icon 7 times.
  2. Enter the password as AIDriven.

    You'll see the Logs option listed in the menu.

  3. Select Logs. Select the log category from the Log Level drop-down list.
    You'll see recent logs based on the selected log level. You can click the Copy button to copy the log details and send the information to the support team for troubleshooting.

  4. Click View to see the logs captured by the Marvis client in your OS native window.
    Note:

    If you contact the Juniper Mist support team to resolve any issue, you might be asked to provide details such as the organization ID, UUID, and organization name. You can find these details listed in the About page, which you can access from the hamburger menu.

    The information in the About page varies based on the operational mode:

    • Production mode—Application version, UUID, and organization name

    • POC and Debug modes—Application version, UUID, mobile SDK secret, organization ID, and organization name

Uninstall the Marvis macOS Client

You can uninstall the Marvis macOS client by using the Finder (GUI) or the CLI. The CLI method offers a clean uninstall option to remove residual files and configurations.

Uninstall the Marvis macOS Client Using the Finder (GUI)

The Finder method provides a user-friendly way to uninstall the Marvis client.

  1. Open the Finder application.

  2. Navigate to the Applications folder.

  3. Locate the Marvis Client application.

  4. Drag the Marvis client icon to the Trash in your Dock, or right-click and select Move to Trash.

To permanently remove the app, open Trash and select Empty Trash.

Note:

This method does not remove all configuration and log files associated with the Marvis client. For more information, see How to Delete Apps on Mac.

Uninstall the Marvis macOS Client Using the CLI

The CLI method provides flexibility for advanced users with the provision of both standard and clean uninstallation of the Marvis client. You'll need administrative privileges for this procedure. Enter your admin password when prompted.

Standard Uninstall

To remove the application only (without configuration files):

  1. Open Terminal.

  2. Run the following command:

    content_copy zoom_out_map
    sudo /Applications/Mist/uninstall.sh

    This command removes the application but retains configuration files, logs, and other associated files.

Clean Uninstall

To completely remove the Marvis client, including all residual files and configurations:

  1. Open Terminal.

  2. Execute the clean uninstall script:

    content_copy zoom_out_map
    sudo /Applications/Mist/uninstall.sh --clean

    This command:

    • Removes the Marvis client application.

    • Deletes configuration files located in /Library/Application Support/Mist.

    • Clears logs and other residual data.

After the uninstallation, navigate to the /Applications and /Users/Shared/MarvisClient folders and verify that all files have been removed.

If you need any assistance, contact the support team.

arrow_backward PREVIOUS Marvis Windows Client
NEXT arrow_forward Marvis-Zebra Integration
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
Marvis macOS Client
keyboard_arrow_right
footer-navigation

© 1999 - 2025 Juniper Networks, Inc. All rights reserved.

Scroll to top

keyboard_arrow_down
file_download
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
language