@@ -534,19 +534,31 @@ https://code.visualstudio.com/docs/remote/linux#_local-linux-prerequisites
534534<details style="margin-bottom :28px;">
535535<summary style="font-size :larger; font-weight: bold;">How can I resolve disconnects when connected to Coder via JetBrains Gateway?</summary>
536536
537- If you leave your JetBrains IDE open for some time while connected to Coder, you
538- may encounter a message similar to the below :
537+ If your JetBrains IDE is disconnected for a long period of time due to a network
538+ change (for example turning off a VPN), you may find that the IDE will not
539+ reconnect once the network is re-established (for example turning a VPN back
540+ on). When this happens a persistent message will appear similar to the below :
539541
540542` ` ` console
541543No internet connection. Changes in the document might be lost. Trying to reconnect…
542544` ` `
543545
544- To resolve this, add this entry to your SSHhost file on your local machine :
546+ To resolve this, add this entry to your SSHconfig file on your local machine :
545547
546548` ` ` console
547549Host coder-jetbrains--*
548550 ServerAliveInterval 5
549551` ` `
550552
551- Note that your SSH config file will be overwritten by the JetBrains Gateway
552- client if it is re-authenticated to your Coder deployment.
553+ This will make SSH check that it can contact the server every five seconds. If
554+ it fails to do so `ServerAliveCountMax` times (3 by default for a total of 15
555+ seconds) then it will close the connection which forces JetBrains to recreate
556+ the hung session. You can tweak `ServerAliveInterval` and `ServerAliveCountMax`
557+ to increase or decrease the total timeout.
558+
559+ Note that the JetBrains Gateway configuration blocks for each host in your SSH
560+ config file will be overwritten by the JetBrains Gateway client when it
561+ re-authenticates to your Coder deployment so you must add the above config as a
562+ separate block and not add it to any existing ones.
563+
564+ </details>