Mac Installation Guide
This guide provides information about installing the strongDM client on your Mac. The client consists of a graphical user interface (GUI) and a command line interface (CLI) utility.
Install the Client
Open the invitation email you received for your strongDM account.
Click the link enclosed in the email to set your password.
Log in to strongDM and download the Mac client from the Download & Install section. You can also download the client directly. The file name appears as SDM-version_number.dmg.
If you are using Homebrew, you can install the strongDM client using
brew install sdm. To uninstall run
brew uninstall sdmand remove the sdm folder with
brew uninstall sdm --zap.
To install the client, double click the downloaded .DMG file.
Drag the SDM app to the Applications folder using the provided shortcut. If you do not have admin rights on your Mac, you can copy the SDM app to the Applications folder in your home directory or the Desktop, where it runs and updates normally without requiring admin privileges.
Do not run SDM directly from the .DMG file. This results in degraded functionality.
Launch the GUI
To launch the application, double click the SDM icon in your list of applications.
The sdm icon appears in the menu bar. Click this icon to log in.
Enter the email and password created during the email invitation step. You may also be redirected to your single sign-on provider instead.
After logging in, a list of resources you have permission to access appears in the GUI.
Click one of these resources to enable a connection and gain access. A green lightning bolt icon appears next to the connected resource.
You may now connect to the resource on your machine using your preferred tool. When prompted for connection information, use localhost for the hostname/IP, leave the username and password blank, and specify the port listed next to the resource in the strongDM GUI. If the connection fails using these defaults, check the Connect to Resources section for more information.
If you click a website resource, it launches in your default browser. To disconnect from any resource, click the named instance in the GUI and the green connection icon disappears. Any existing connections from your local machine to the resource are immediately disabled.
Set up the CLI
After installing the SDM application, click the sdm icon in the menu bar. Make sure you are logged in by checking that the SDM application is online and your available resources display.
Open the strongDM menu and click install 'sdm' in PATH.
You can also open a terminal and type
sudo ln -s /Applications/SDM.app/Contents/Resources/sdm.darwin /usr/local/bin/sdm. Either of these options links the sdm command line application into your PATH. To verify that it is working properly, type:$ sdm --versionsdm-cli version 32.96.0 (3ce787f5b438303ad78cc4907f1d81bc9ec09945 #296)
If instead you see something like
-bash: sdm: command not found, it may mean that the path
/usr/local/bin/is not included in your system search path. Edit the shell configuration file your system is using. On a Mac, that is sometimes
.bash_profile, but since macOS Catalina zsh is the default shell. Open the shell configuration file and append
export PATH=/usr/local/bin/:$PATHto it. Then run:$ source ~/.zshrc$ sdm --versionsdm-cli version 32.96.0 (3ce787f5b438303ad78cc4907f1d81bc9ec09945 #296)
If any errors occur or if the installation fails in any way, please contact firstname.lastname@example.org for assistance.