Troubleshoot common issues.
IntelliJ IDEA freezes over remote desktop
If IntelliJ IDEA freezes, shows a blank window, or stops responding on a remote Linux desktop accessed through XRDP, VNC, X11 forwarding, or NoMachine, Java 2D hardware acceleration may be incompatible with the remote graphics driver. Try disabling the related rendering options.
- In the remote IntelliJ IDEA instance, select Help > Edit Custom VM Options.
- Add the following options at the end of the file. If an option already exists, update its value instead of adding a duplicate.
- Save the file, restart IntelliJ IDEA, and check whether the interface responds normally.
~/.config/JetBrains/<Idea-Version>/idea64.vmoptions. Replace <Idea-Version> with the actual version directory.
These options disable OpenGL, XRender, and offscreen pixmap rendering options to help troubleshoot compatibility with the remote graphics environment.
Chinese text appears as boxes in JetBrains Gateway
If Chinese characters in Qoder CN responses appear as boxes when you connect to a remote Linux development environment through JetBrains Gateway, check that the remote Linux server has Chinese fonts installed and font fallback configured.
Qoder CN uses the IDE's UI font, which is separate from the code editor font. Inter does not contain Chinese glyphs. SansSerif is a logical font whose Chinese rendering depends on system fonts and fallback configuration, so changing only the editor font may not resolve the issue.
1. Install Chinese fonts on the remote server
Choose the commands for the remote server's distribution. Software installation permissions are required.
Red Hat
~/.config/fontconfig/fonts.conf in that user's home directory. If the file already exists, merge the following rules into its existing <fontconfig> element and keep other settings.
Inter and maps SansSerif, sans-serif, and serif to Chinese fonts.
3. Refresh the font cache and check font matching
Noto Sans CJK SC. fc-match Inter may still return Inter because it remains the preferred font; this does not mean Chinese fallback has failed.
4. Restart the remote IDE instance
Restart the remote IDE instance connected through Gateway, reconnect, and ask Qoder CN a question to check that Chinese text displays correctly.
What should I do if the JetBrains plugin can’t connect after an update, or the repair fails?
- If the IDE asks you to restart to finish the plugin update, save your work and restart it.
- Reopen your project. If Qoder or Qoder CN still can’t connect, open Issue Report > Troubleshooting > Repair local service in the plugin tool window.
- Finish any active Qoder tasks, then select Start repair. Other IDEs sharing the service will temporarily disconnect.
- When you see “Local service repaired and started,” return to the chat and resend the message that previously failed. If the message says the current service is available, you can continue working and retry the repair later.
- The old service won’t stop, or access is denied. Save your work and exit the current IDE. Also exit any other JetBrains IDEs open on your computer, such as IntelliJ IDEA, PyCharm, or GoLand, including additional project windows. Then start just one IDE, open one project, and run the repair again.
- Installation failed. Check free disk space and read/write access to the local storage directory in the plugin settings.
- Versions differ. Update the corresponding plugins in the IDEs sharing the service to the same version, and restart the IDEs when prompted.