Troubleshooting

Setup

Question	Answer
Is there a difference between JetBrains Gateway from Toolbox, the one downloaded separately, or the one from an IDE?	Standalone JetBrains Gateway supports an option to "Open in IDE" your Space-based project If you don't use it, there are no other differences in installers and workflows. Check the installation scenarios.
Can I point Remote Development to an existing IDE on my remote server? Is it possible to install IDE manually?	Since version 221.5481, you can manually register an existing backend IDE on the remote server and make it visible for JetBrains Gateway. Installed IDE will appear in the list of available builds: Enter remote server by SSH. Locate the folder with unpacked IDE, enter `bin` folder. In the command line, execute the following command: `remote-dev-server.sh registerBackendLocationForGateway` For example, `sh PhpStorm-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway`
The JetBrains Gateway installation itself doesn't finish successfully	Ensure your system user has permissions to install a software or contact a system administrator in your organization.
Why does the SSH connection to a remote server fail during the setup?	Firewall on the remote server side or the virtual machine provider prohibits incoming connection. In the case of AWS, don't forget to adjust "Security groups" On the remote side, your SSH listens to a non-standard port Password or key file is incorrect or your connection was blocked due to several failures
JetBrains Gateway hangs on the Retrieving IDE versions step and doesn't load available IDEs	JetBrains Gateway can't connect to JetBrains' site to fetch the list of existing builds
JetBrains Gateway tries to connect but fails. Credentials are 100% correct.	Ensure `AllowТcpForwarding` in `sshd_config` on the remote server is enabled as it's required for redirecting remote IDE process' traffic to your local machine.
I select an IDE installer from the local machine, but the process of uploading fails	The remote server doesn't have enough available space on the disk. The available space on your remote server must be at least 4xIDE.tar.gz in size. Since version 2022.1.1, you can select a custom path on the remote server as the deployment target location. You uploaded not .tar.gz installer archive, so it can't be unpacked on the remote side
Upload of remote-dev-worker fails with "exit code: 139 (SIGSEGV)"	If your remote machine's OS is RHEL, CentOS, RockyLinux - check syslog for SELinux warnings or disable SELinux and retry installation
On local machine, process fails with the "Failed to download JetBrains Client" error	Your local computer must have a network connection to the following JetBrains URLs: https://code-with-me.jetbrains.com https://download.jetbrains.com https://download-cf.jetbrains.com https://download-cdn.jetbrains.com https://cache-redirector.jetbrains.com Alternatively, you can configure the fully offline mode.

Work with remote project

Question	Answer
Failed to get IDE status in 60 seconds. Probably IDE backend is stuck	Backend server's shell is interactive or has config errors, so deployment commands don't finish correctly. Try to replace it with a default config or simple bash Backend IDE hangs due to lack of resources and doesn't respond: 1. Enter the remote server by ssh and terminate IDE processes manually. 2. Add memory to the remote IDE by editing JVM options file. Default deploy settings can be not suitable for average or big projects. 3. Locate remote IDE JVM settings file: `$IDE_BIN_DIR/${IDE_PRODUCT_VM_OPTIONS}.vmoptions` Check the following example: `./.cache/JetBrains/RemoteDev/dist/a17ad99f7faf8_ideaIU-2021.3.1/bin/idea64.vmoptions` 4. Edit `-Xmx` value and repeat the deploy/connection with new settings Backend IDE can't process your project in general (lack of resources, wrong configuration, broken dependencies). Enter the remote server by ssh and launch the project manually as described on this page and check the output. If the project started successfully, copy the generated link and try connect from the local Gateway (also described in the article).
CPU or resources usage looks abnormal	To diagnose performance problems, support needs logs (Help -> Collect Host and Client logs), CPU snapshot from the server (Help -> Diagnostic Tools -> Start CPU Usage Profiling), and heap dumps (files like `java_error_in_idea*.hprof`) For more information about diagnosing performance problems, refer to Reporting performance problems
IDE hangs and doesn't respond	When IDE hangs and doesn't respond so that you can't use the menu to capture the snapshot, provide us with the thread dumps
The remote IDE worked but stopped responding	Enter the remote server and terminate IDE processes or reboot the server, then re-test. In future versions, we plan to support a self-healing restart.

Thanks for your feedback!

Was this page helpful?