Mac Installation Guide

  1. 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.

  2. After logging in, download the Mac client from the web UI, or directly with this link. The file will appear as: SDM-<VERSION_NUMBER>.dmg

  3. 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 Applications folder in your home directory (if there is no Applications folder, you can create one), or the Desktop, where it will run and update normally without admin privileges required.

    "Installation"

    Optional: After installing SDM, you can drag the SDM app from the Applications folder into your dock at the bottom of the screen.

    Warning: Do not run SDM directly from the .dmg file. This will result in degraded functionality.

  4. 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.

  5. Once you have logged in, a list of datasources and servers you have permission to access will appear in the SDM menu bar dropdown.

  6. To enable a connection to one of the servers or datasources, 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 localhost or 127.0.0.1 and the listed port. To disconnect, simply click the named instance and you’ll see the green icon disappear. This will break any existing database connections to this instance.

    "Connections available in Mac UI"

  7. 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/sdm

    Either of these will symbolically link the sdm command line application into your PATH. To verify that it’s working properly, type the following:

     $ sdm --version
     sdm version 0.7.3 (1e81040de1c44703a8e9067782fbb9f9fd22b00e #253)
    

    If instead, you see something like this: -bash: sdm: command not found it most likely means that the path /usr/local/bin/ is not included in your system search path. You’ll have to edit whichever bash profile file your system is using. On a Mac, that is likely ~/.bash_profile. Open this file for editing, and then append this line to it.

    export PATH=/usr/local/bin/:$PATH

    Then, run these commands.

     $ source ~/.bash_profile
     $ sdm --version
     sdm version 0.7.3 (1e81040de1c44703a8e9067782fbb9f9fd22b00e #253)
    
  8. If any errors occur or if the installation fails in any way, please contact support@strongdm.com for assistance.