Home
/
/
/

This article walks you through the process of configuring Coder to support the use of multiple instances of the same JetBrains IDE.

Multiple IntelliJ icons in a
workspace

You will:

  1. Create and build the custom image
  2. Write the configure script
  3. Write the config.yaml file needed to utilize Coder's [workspace applications] feature to surface additional JetBrains IDE instances in your browser

This article shows you how to configure multiple instances of IntelliJ IDEA Ultimate, but you can use this process for any JetBrains IDEs.

Using additional JetBrains IDEs consume extra workspace compute resources, so ensure that you've allocated enough resources to your workspace to support all of your IDE instances.

  1. Build a custom image that installs the primary JetBrains IDE and copies the configure script, .profile script, and config.yaml file to the image:

    FROM codercom/enterprise-java:ubuntu
    
    USER root
    
    # Install IntelliJ IDEA Ultimate
    RUN mkdir -p /opt/idea
    RUN curl -L \
    "https://download.jetbrains.com/product?code=IU&latest&distribution=linux" \
    | tar -C /opt/idea --strip-components 1 -xzvf -
    
    # Create a symbolic link in PATH that points to the Intellij startup script.
    RUN ln -s /opt/idea/bin/idea.sh /usr/bin/intellij-idea-ultimate
    
    # bash .profile so projector can be added to the path
    COPY [".profile", "/coder/.profile"]
    
    # configure script
    COPY ["configure", "/coder/configure"]
    RUN chmod +x /coder/configure
    
    # copy custom apps info (config.yaml)
    COPY ["./coder", "/coder"]
    
    # Set back to coder user
    USER coder
    
  2. Add the JetBrains Projector CLI to the workspace's PATH (in this example, .profile is located in the Coder directory within the directory that contains the image's Dockerfile:

    export PATH=$PATH:$HOME/.local/bin
    
  3. Create the configure script that installs the Projector CLI into /home/coder and uses the CLI to install additional JetBrains IDEs. Each IDE configuration has a different directory in /home/coder/.projector/configs. In this example, the configure script is in the directory that contains the image's Dockerfile:

    Each additional IDE requires a unique port number.

    # install projector into /home/coder/ pvc
    pip3 install projector-installer --user
    
    # put projector CLI into path
    cp /coder/.profile $HOME
    source $HOME/.profile
    
    # autoinstall intellij version specifying config name and port
    $HOME/.local/bin/projector --accept-license
    
    PROJECTOR_CONFIG_PATH=$HOME/.projector/configs/IntelliJ_2
    
    if [ -d $PROJECTOR_CONFIG_PATH ]; then
        echo 'projector has already been configured - skip step'
    else
        $HOME/.local/bin/projector ide autoinstall --config-name IntelliJ_2 \
        --ide-name "IntelliJ IDEA Ultimate 2021.3.2" --port 8997 \
        --use-separate-config
        $HOME/.local/bin/projector ide autoinstall --config-name IntelliJ_3 \
        --ide-name "IntelliJ IDEA Ultimate 2021.3.2" --port 8998 \
        --use-separate-config
        $HOME/.local/bin/projector ide autoinstall --config-name IntelliJ_4 \
        --ide-name "IntelliJ IDEA Ultimate 2021.3.2" --port 8999 \
         --use-separate-config
    fi
    
  4. Create the config.yaml file used by workspace applications to surface icons for each additional JetBrains IDE in the workspace. The configuration uses the JetBrains icon included with the initial JetBrains IDE installed.

    In this example, config.yaml is located in a coder/apps directory within the directory that contains the image Dockerfile.

    Each workspace application name must be unique so that Projector can point to the correct config directory.

    # /coder/apps/config.yaml
    apps:
      # Name of application in launcher. Name may consist of alphanumeric
      # characters, dashes, underscores. Names must begin with an alphanumeric
      # character. Names must be unique per application. Required.
      - name: IntelliJ IDEA Ultimate 2
        # Application scheme - must be http or https. Required.
        scheme: http
        # Application port. Required.
        port: 8997
        # Host of the application to use when dialing. Defaults to localhost.
        # Optional.
        host: "localhost"
        # Working directory for the start command. Required.
        working-directory: /home/coder
        # File path to icon used in application launcher. Icons should be either
        # PNG, SVG, or JPG. Required.
        icon-path: /opt/idea/bin/idea.svg
        # Command to start the application. Required.
        command: /home/coder/.projector/configs/IntelliJ_2/run.sh
        # Array of arguments for command. Optional.
        args: [""]
        # Health checks to get running application status. Can use exec or http
        # health checks to localhost. Optional, but we recommend specifying a
        # health check. If you don't supply one, then an http request is sent to
        # the application root path "/".
        health-check:
          http:
            # Scheme must be "http" or "https". If not specified it inherits
            # the application scheme. Optional.
            scheme: "http"
            # The host to use when dialing the address. If not specified it
            # inherits the application host. Optional.
            host: "localhost"
            # Port to use when dialing the application. If not specified it
            # inherits the application port. Optional.
            port: 8997
      - name: IntelliJ IDEA Ultimate 3
        # Application scheme - must be http or https. Required.
        scheme: http
        # Application port. Required.
        port: 8998
        # Host of the application to use when dialing. Defaults to localhost.
        # Optional.
        host: "localhost"
        # Working directory for the start command. Required.
        working-directory: /home/coder
        # File path to icon used in application launcher. Icons should be either
        # PNG, SVG, or JPG. Required.
        icon-path: /opt/idea/bin/idea.svg
        # Command to start the application. Required.
        command: /home/coder/.projector/configs/IntelliJ_3/run.sh
        # Array of arguments for command. Optional.
        args: [""]
        # Health checks to get running application status. Can use exec or http
        # health checks to localhost. Optional, but we recommend specifying a
        # health check. If you don't supply one, then an http request is sent to
        # the application root path "/".
        health-check:
          http:
            # Scheme must be "http" or "https". If not specified it inherits
            # the application scheme. Optional.
            scheme: "http"
            # The host to use when dialing the address. If not specified it
            # inherits the application host. Optional.
            host: "localhost"
            # Port to use when dialing the application. If not specified it
            # inherits the application port. Optional.
            port: 8998
      - name: IntelliJ IDEA Ultimate 4
        # Application scheme - must be http or https. Required.
        scheme: http
        # Application port. Required.
        port: 8999
        # Host of the application to use when dialing. Defaults to localhost.
        # Optional.
        host: "localhost"
        # Working directory for the start command. Required.
        working-directory: /home/coder
        # File path to icon used in application launcher. Icons should be either
        # PNG, SVG, or JPG. Required.
        icon-path: /opt/idea/bin/idea.svg
        # Command to start the application. Required.
        command: /home/coder/.projector/configs/IntelliJ_4/run.sh
        # Array of arguments for command. Optional.
        args: [""]
        # Health checks to get running application status. Can use exec or http
        # health checks to localhost. Optional, but we recommend specifying a
        # health check. If you don't supply one, then an http request is sent to
        # the application root path "/".
        health-check:
          http:
            # Scheme must be "http" or "https". If not specified it inherits
            # the application scheme. Optional.
            scheme: "http"
            # The host to use when dialing the address. If not specified it
            # inherits the application host. Optional.
            host: "localhost"
            # Port to use when dialing the application. If not specified it
            # inherits the application port. Optional.
            port: 8999
    

See Projector's CLI documentation for additional information on installation and the CLI commands it accepts.

See an opportunity to improve our docs? Make an edit.