Mac Installation Guide
You should have received an email inviting you to your strongDM account. Open the invitation email and click the enclosed link to set your password.
After logging in, download the Mac client from the Admin UI, or directly with this link. The file will appear as:
If you are a user of Homebrew, you can skip the download and installation steps and instead, install the strongDM client using:
brew install sdm(and uninstall it with
brew uninstall sdmor uninstall it and remove the .sdm folder with
brew uninstall sdm --zap). Thanks to Nick Hobart from Clearcover for setting up strongDM on Homebrew!
To install strongDM from the downloaded file, double click the downloaded .dmg file to open the strongDM disk image, and then 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
Applicationsfolder in your home directory (if there is no
Applicationsfolder, you can create one), or the Desktop, where it will run and update normally without admin privileges required.
After installing strongDM, you can drag the SDM app from the Applications folder into your dock at the bottom of the screen.
Do not run SDM directly from the
.dmgfile. This will result in degraded functionality.
To launch the application, double click on the SDM icon. The SDM icon will appear in the menu bar at the top right of your screen. To login, click the SDM icon in the menu. Your username will be your email address and the password will either be the same you created in the first step or you will be redirected to your single sign-on provider.
Once you have logged in, a list of resources you have permission to access will appear in the GUI (in the menu bar dropdown).
To enable a connection to one of the resources, simply click the one you'd like to access. A green icon will appear next to the datasource you've connected to. At this point you may connect to it with your preferred tool using
127.0.0.1and the listed port. If it is a website resource, clicking it will launch it in your default browser. To disconnect, simply click the named instance in the GUI and you'll see the green icon disappear. This will break any existing database connections to this instance.
Finally, set up the CLI utility. After installing the sdm application, click on the menu in the upper right of the GUI and click install 'sdm' in PATH. Alternately, open a terminal prompt and type the following:
sudo ln -s /Applications/SDM.app/Contents/Resources/sdm.darwin /usr/local/bin/sdmEither of these will symbolically link the sdm command line application into your PATH. To verify that it's working properly, type the following:$ sdm --versionsdm-cli version 30.13.0 (d9b5d467efab6dcd2c35975c655167116fc7014e #13)
If instead, you see something like this:
-bash: sdm: command not foundit most likely means that the path
/usr/local/bin/is not included in your system search path. You'll have to edit whichever shell profile file your system is using. On a Mac, that is sometimes
.bash_profile. Open this file for editing, and then append this line to it.
export PATH=/usr/local/bin/:$PATHThen, run these commands.$ source ~/.bash_profile$ sdm --versionsdm-cli version 30.13.0 (d9b5d467efab6dcd2c35975c655167116fc7014e #13)
If any errors occur or if the installation fails in any way, please contact firstname.lastname@example.org for assistance.