Skip to main content Skip to complementary content

Launching Talend Studio and fetching your license

This section shows you how to launch Talend Studio and log in to it either via Talend Cloud or in the traditional mode.

Launching Talend Studio and logging in to it via Talend Cloud

If you are working with Talend Cloud, you can launch Talend Studio and log in to it via Talend Cloud.

Information noteNote: Logging in to Talend Studio via Talend Cloud is currently unsupported for Linux on ARM64.

Before you begin

  • You must have the predefined Integration Developer role to fetch the license from Talend Management Console.

  • To avoid selecting your region manually when connecting to Talend Cloud, you can set the default region for Talend Cloud by adding the -Dtalend.tmc.datacenter=<region> parameter in the corresponding .ini file under the Talend Studio installation directory according to your operating system. <region> is the abbreviation of the region, which can be found in the Talend Cloud URL. For example, ap for the Asia Pacific region, and us-west for the United States — West region. For more information, see Talend Cloud regions and URLs.

Procedure

  1. Go to the Talend Studio installation directory.
    The Talend Studio installation directory contains binaries for several platforms including Windows, Linux, and MacOS.
  2. If you are not working on Rocky Linux 8.5, double-click the executable file corresponding to your operating system.
    Operating systems and their corresponding executable files
    Operating system Executable file

    Windows

    Talend-Studio-win-x86_64.exe

    Linux on x86

    Talend-Studio-linux-gtk-x86_64

    MacOS on x86

    Talend-Studio-macosx-cocoa.app

    MacOS on ARM

    Talend-Studio-macosx-cocoa-aarch64.app

    Note that if you work on MacOS and install Talend Studio manually using the zip archive file, you might get one of the following two messages as shown in below screenshots when trying to launch Talend Studio for the first time. To fix the issue, you can open the terminal, go to the directory above the Talend Studio top directory, execute the command xattr -d com.apple.quarantine <Talend-Studio>/*, where <Talend-Studio> is the root folder name of Talend Studio, and then relaunch your Talend Studio.

    Talend Studio error messages upon startup
  3. If you are working on Rocky Linux 8.5, do the following:
    1. Create a start.sh file under the Talend Studio installation directory and edit it by adding the following content corresponding to the processor of your PC, where <Talend-Studio-executable-file-name> is the Talend Studio executable file name.
      #!/bin/sh
      export GDK_BACKEND=x11
      ./<Talend-Studio-executable-file-name>
    2. Open the terminal.
    3. Run the chmod +x start.sh command.
    4. Run the ./start.sh command.
  4. If you launch Talend Studio for the first time, in the User License Agreement dialog box that opens, read, and accept the terms of the end user license agreement.
  5. In the dialog box that opens, click Edit settings and in the Preferences dialog box that opens, switch to another workspace and configure the network settings if needed.
  6. Click Log in with Talend Cloud .
    Talend Cloud login wizard in Talend Studio

    You are redirected to the Talend Cloud login page.

  7. From the Talend Cloud login page, log in to Talend Cloud either with SSO or in the regular way according to your needs, and in the pop-up dialog box, click Open Talend_Sign_On_Tool.

    For more information about logging in to Talend Cloud, see Logging in to Talend Management Console.

    Talend Cloud SSO login wizard from Talend Studio
  8. Switch to your Talend Studio instance.

    If an Authentication dialog box for logging in to the update repositories pops up, enter your user name and password for the update repositories and click OK. For more information, see Basic authentication for update repositories in Talend Studio.

    If needed, click Switch sign in to go back to where you can choose the login mode, or click Manage connection and in the dialog box that opens, switch to another workspace.

  9. Select the branch and the project you want to work on and click Open.

Results

You can now start working with your project and items.

If you want to use those features that are not shipped with Talend Studio by default, you need to install them using the Feature Manager wizard. For more information, see Managing features in Talend Studio.

Talend Studio requires specific third-party Java libraries or database drivers (.jar files) to be able to connect to sources and targets. These libraries or drivers, known as external modules, are required by some Talend components and/or connection wizards. Due to license restrictions, Talend may not be able to ship certain external modules within Talend Studio. For more information, see Installing external modules.

Launching Talend Studio in the traditional mode

You can launch Talend Studio in the traditional mode by following the procedure below.

Before you begin

You must have the predefined Integration Developer role to fetch the license from Talend Management Console.

Procedure

  1. Go to the Talend Studio installation directory.
    The Talend Studio installation directory contains binaries for several platforms including Windows, Linux, and MacOS.
  2. If you are not working on Rocky Linux 8.5, double-click the executable file corresponding to your operating system.
    Operating systems and their corresponding executable files
    Operating system Executable file

    Windows

    Talend-Studio-win-x86_64.exe

    Linux on x86

    Talend-Studio-linux-gtk-x86_64

    Linux on ARM

    Talend-Studio-gtk-aarch64

    MacOS on x86

    Talend-Studio-macosx-cocoa.app

    MacOS on ARM

    Talend-Studio-macosx-cocoa-aarch64.app

    Note that if you work on MacOS and install Talend Studio manually using the zip archive file, you might get one of the following two messages as shown in below screenshots when trying to launch Talend Studio for the first time. To fix the issue, you can open the terminal, go to the directory above the Talend Studio top directory, execute the command xattr -d com.apple.quarantine <Talend-Studio>/*, where <Talend-Studio> is the root folder name of Talend Studio, and then relaunch your Talend Studio.

    Talend Studio error messages upon startup
  3. If you are working on Rocky Linux 8.5, do the following:
    1. Create a start.sh file under the Talend Studio installation directory and edit it by adding the following content corresponding to the processor of your PC, where <Talend-Studio-executable-file-name> is the Talend Studio executable file name.
      #!/bin/sh
      export GDK_BACKEND=x11
      ./<Talend-Studio-executable-file-name>
    2. Open the terminal.
    3. Run the chmod +x start.sh command.
    4. Run the ./start.sh command.
  4. If you launch Talend Studio for the first time, in the User License Agreement dialog box that opens, read, and accept the terms of the end user license agreement.
  5. In the dialog box that opens, click Other login mode.
  6. In the dialog box that opens, perform one of the following actions and click Next:
    • If your license has been set in Talend Management Console and you want to retrieve this license, select the My product license is on a remote host option, select a Talend Cloud server or Cloud - Custom from the list, enter the server URL if needed, provide the login credentials, and then click Fetch to retrieve the license.

      You can check your login name or generate a personal access token from your Profile Preferences in Talend Cloud. Note that for security reasons, you cannot use a token that is older than 60 days to connect to Talend Studio. For more information, see Generating a Personal Access Token.

    • If your license has been set in Talend Administration Center and you want to retrieve this license, select the My product license is on a remote host option, select Server URL from the list, enter the server URL and the login credentials, and then click Fetch to retrieve the license.
    • If your license is on your local file system, select the My product license is on the local file system option, and then browse to your license file and select it.
    Information noteTip:
    • If you want to retrieve the license from a remote host that is working behind a proxy server, click Network settings and in the Preferences dialog box that opens, configure the proxy settings.
    • If you use proxy that requires authentication to connect to Talend Management Console or Talend Administration Center that uses HTTPs and get the error message 407 proxy authorization required, add the parameter -Djdk.http.auth.tunneling.disabledSchemes with the empty value in the corresponding .ini file according to your operating system and relaunch Talend Studio.
  7. To import projects or project items exported from earlier versions of Talend Studio, click Set migration token and in the pop-up dialog box, enter your migration token.
    If you do not have a migration token, contact Talend support to request it.
  8. Click Next.

    If an Authentication dialog box for logging in to the update repositories pops up, enter your user name and password for the update repositories and click OK. For more information, see Basic authentication for update repositories in Talend Studio.

    The Talend Studio login window displays. A default local or remote connection is automatically set up based on how you fetch your license. With different connections, you can select an existing project, create a new project, import a demo project, or import an existing project exported from an earlier version of Talend Studio according to your needs.

    You can also manually set up either a local connection or a remote connection to Talend Management Console or Talend Administration Center according to your needs. For more information, see Managing connections in Talend Studio.

    Information noteTip:

    If Talend Studio fails to connect to the remote server, a dialog box is displayed to allow you to:

    • Retry connecting to the remote server.
    • Modify the connection timeout time to allow more retries. The value 0 means no connection timeout.

    If needed, click Cancel to close the dialog box and check your connection details.

    If you get an invalid registry error, add the osgi.nl=en_US parameter in the <Talend-Studio>/configuration/config.ini file and relaunch Talend Studio by running the following command, where <Talend-Studio-executable-file> is the executable file corresponding to your operating system.

    • Windows: <Talend-Studio-executable-file> -clean from a command prompt
    • Linux: ./<Talend-Studio-executable-file> -clean from a terminal
    • MacOS: ./<Talend-Studio-executable-file>/Contents/MacOS/Talend-Studio-macosx-cocoa -clean from a command prompt

    The -clean parameter is needed only once. It is recommended not to use it when launching Talend Studio by running the executable file directly.

  9. If needed, click Switch sign in to go back to where you can choose the login mode.
  10. Click Open.

Results

You can now start working with your project and items.

If you want to use those features that are not shipped with Talend Studio by default, you need to install them using the Feature Manager wizard. For more information, see Managing features in Talend Studio.

Talend Studio requires specific third-party Java libraries or database drivers (.jar files) to be able to connect to sources and targets. These libraries or drivers, known as external modules, are required by some Talend components and/or connection wizards. Due to license restrictions, Talend may not be able to ship certain external modules within Talend Studio. For more information, see Installing external modules.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!