Start ALM using ALM Client Launcher

This task describes how to launch ALM on your machine using ALM Client Launcher. You can work with multiple versions of ALM side-by-side on a client machine.

To start ALM:

  1. Enter your ALM URL in your browser.
    http://<ALM server name/IP address>[<:port number>]/qcbin. Contact your system administrator if you do not have the correct URL.

  2. For Single-Sign-On users:

    1. If the user discovery page is displayed, add your user name or email address as specified in ALM. Click Submit.
    2. In the IDP page, add your IDP credentials. Click the log in button.
  3. In the Application Lifecycle Management Options window, click ALM Desktop Client link.

  4. If you already have ALM Client Launcher installed, click Open ALM Client Launcher in the confirmation dialog box.

  5. If you did not install ALM Client Launcher, from the Download ALM Client Launcher page, select where to download ALM Client Launcher, from Marketplace or ALM Server, and click Download. Save the download file and run it.

    For details about how to use ALM Client Launcher, see ALM Client Launcher.

  6. In the login page, provide the following information:

    User name

    Enter your username.

    Not available for Single-Sign-On users.


    Enter the password assigned to you by your site administrator.

    Available in 16.0.1 and later: You can click and hold the eye icon () next to your password to show it in plain text.

    Not available for Single-Sign-On users.

    Forgot Password

    If you cannot remember your password, click link to reset your password. For details, see Reset your password

    Not available for Single-Sign-On users.

    Automatically log in to my last domain and project on this machine

    Select check box if you want ALM to automatically log in to the last project in which you were working.

    Not available for Single-Sign-On users.


    Click to verify your user name and password. ALM determines which domains and projects you can access. If you specified automatic login, ALM opens.

    If authentication fails, check that your user name and password are correct and try again.


    • If authentication fails multiple times, you can be locked out of ALM. The number of authentication attempts you are allowed is determined by your site administrator. For details, see Lock and unlock users.

    • Not available for Single-Sign-On users.

    Domain Select a domain. By default, the last domain in which you were working is displayed.

    Select a project. By default, the last project in which you were working is displayed.


    ALM opens and displays the module in which you last worked during your previous session.

    The first time you run ALM, the Welcome page opens.

    When an ALM user session is inactive for a period of time, the session expires. This releases the license in use, making it available for other users. When a session expires, you are prompted to reconnect.

    You can edit reconnect options by modifying the FAST_RECONNECT_MODE parameter in the Site Configuration tab. This parameter is not valid for external authentication, since the user must always be certified when reconnecting. For details, see Set configuration parameters.

Back to top

See also: