Start and log in to Surround SCM

Make sure the Helix ALM License Server and Surround SCM Server are running before you start Surround SCM.

If this is your first time using Surround SCM and you have not set up any users, you can log in as the default administrative user. The username is Administrator and there is no password.

If you try to log in and the license server is not running or is not found, you are prompted to log in using the local SCM admin password. This allows you to log in and verify the license server settings.

1. Windows—Choose Programs > Perforce > Surround SCM > Surround SCM Client.

Mac—Double-click the Surround SCM Client icon in the Applications/Surround SCM folder.

Linux—Enter /usr/bin/scmgui

The login dialog box opens.

2. Select the Server to connect to. If you need to add a server, see Adding server connections.

3. Enter your Username and Password.

You do not need to enter a password if you authenticate using an identity provider, such as Okta.

If available, you can select Use single sign-on to log in with your network credentials Single sign-on is only available for Windows and Mac. Ask your administrator for help.

If you do not remember your password, click Forgot Password? to reset your password. You will receive an email with a temporary password and instructions for resetting your password. Ask your administrator if you need additional help.

4. Select Always log in with this username and password to automatically log in using the credentials you entered every time Surround SCM starts.

If you select this option, Surround SCM will automatically use Windows Credential Manager or macOS Keychain Access to store your credentials.

To clear this option, choose Tools > User Options > General and clear the Always log in with this username and password option. You can also clear the option the next time you log in.

5. Click Connect.

You are logged in and ready to start using Surround SCM.

If you use an identity provider to authenticate, the provider web page opens. Authenticate with the provider and then return to Surround SCM.

If a valid Surround SCM license is not found on the license server, you are prompted to enter a serial number. Enter a serial number in the Add License dialog box and click OK.