From 9cde559277127f3f8843052f63fb914cf5e50a98 Mon Sep 17 00:00:00 2001 From: Christopher Hakkaart Date: Mon, 21 Sep 2026 17:15:29 +1200 Subject: [PATCH] Draft --- .../studios_troubleshooting.md | 13 ++++++++++++- .../studios_troubleshooting.md | 13 ++++++++++++- .../studios_troubleshooting.md | 13 ++++++++++++- 3 files changed, 36 insertions(+), 3 deletions(-) diff --git a/platform-cloud/docs/troubleshooting_and_faqs/studios_troubleshooting.md b/platform-cloud/docs/troubleshooting_and_faqs/studios_troubleshooting.md index cf5dc22b2..d6ca5f979 100644 --- a/platform-cloud/docs/troubleshooting_and_faqs/studios_troubleshooting.md +++ b/platform-cloud/docs/troubleshooting_and_faqs/studios_troubleshooting.md @@ -2,7 +2,7 @@ title: "Studios" description: "Studios troubleshooting with Seqera Platform." date created: "2024-08-26" -last updated: "2026-08-28" +last updated: "2026-09-21" tags: [faq, help, studios, troubleshooting] --- @@ -169,6 +169,17 @@ If you receive a permission denied error, there are several possible causes: 2. Check that the user's SSH public key is configured in their Seqera user profile. 3. Ensure SSH was enabled when starting the Studio using the **SSH Connection** toggle. The SSH setting defaults to disabled for new Studios. 4. Ensure the Studio is built with Connect client version 0.10.0 or later. +5. If some concurrent connections fail while others succeed with the same key, connect one session at a time. If sequential connections succeed, your key and permissions are correct. The concurrent connections exceeded the rate limit for SSH authorization, which the proxy reports as an authentication failure. To resolve, open fewer connections at the same time. + +### SSH command exits with code 255 but no error message + +```bash +ssh alice@a01ac8894@connect.example.com -p 2222 ls /workspace +echo $? +# 255 +``` + +The command completes with full output, but the SSH client exits with code 255 and prints no error. This issue occurs when the Connect proxy closes the SSH channel before it relays the exit status of the command. Many concurrent connections, or a command that produces no output, make it more likely. Any caller that reads exit codes, such as a script, `scp`, Git over SSH, or VS Code Remote SSH, treats the successful command as a failure. To confirm, check that the output of the command is complete. As a workaround, verify the result of the command before you retry it, because a retry repeats a command that already succeeded. ### VS Code Remote SSH not working diff --git a/platform-enterprise_docs/troubleshooting_and_faqs/studios_troubleshooting.md b/platform-enterprise_docs/troubleshooting_and_faqs/studios_troubleshooting.md index 02f309c5d..7b16160c6 100644 --- a/platform-enterprise_docs/troubleshooting_and_faqs/studios_troubleshooting.md +++ b/platform-enterprise_docs/troubleshooting_and_faqs/studios_troubleshooting.md @@ -2,7 +2,7 @@ title: "Studios" description: "Studios troubleshooting with Seqera Platform." date created: "2024-08-26" -last updated: "2026-08-28" +last updated: "2026-09-21" tags: [faq, help, studios, troubleshooting] --- @@ -221,6 +221,7 @@ If you receive a permission denied error, there are several possible causes: 1. Verify the user has the correct role and permissions in the workspace. 2. Check that the user's SSH public key is configured in their Seqera user profile. 3. Ensure SSH was enabled when adding the Studio using the **SSH Connection** toggle. The SSH setting persists across stop/start but defaults to disabled for new Studios. +4. If some concurrent connections fail while others succeed with the same key, connect one session at a time. If sequential connections succeed, your key and permissions are correct. The concurrent connections exceeded the rate limit for SSH authorization, which the proxy reports as an authentication failure. This applies only when `MICRONAUT_ENVIRONMENTS` includes `ratelim`. To resolve, open fewer connections at the same time, or raise `TOWER_RATELIMIT_PERIOD`. See [Seqera API](../enterprise/configuration/overview#seqera-api) for the rate limit variables. If the issue persists, verify your administrator configured the SSH environment variables during Studios deployment. @@ -250,6 +251,16 @@ Check Studio logs for: The `authorized` field should be `true` and `expected` should equal `incoming`. If they differ, the proxy SSH key configuration is incorrect. +#### SSH command exits with code 255 but no error message + +```bash +ssh alice@a01ac8894@connect.example.com -p 2222 ls /workspace +echo $? +# 255 +``` + +The command completes with full output, but the SSH client exits with code 255 and prints no error. The proxy logs a clean session. This issue occurs when connect-server/proxy version 0.12.1 or 0.12.2 closes the SSH channel before it relays the exit status of the command. Many concurrent connections, or a command that produces no output, make it more likely. Any caller that reads exit codes, such as a script, `scp`, Git over SSH, or VS Code Remote SSH, treats the successful command as a failure. To confirm, check that the output of the command is complete. As a workaround, verify the result of the command before you retry it, because a retry repeats a command that already succeeded. + #### VS Code Remote SSH not working If VS Code fails to connect or shows errors when using the Remote SSH extension, disable local server mode in VS Code settings: diff --git a/platform-enterprise_versioned_docs/version-26.1/troubleshooting_and_faqs/studios_troubleshooting.md b/platform-enterprise_versioned_docs/version-26.1/troubleshooting_and_faqs/studios_troubleshooting.md index 827e958fd..29996e08b 100644 --- a/platform-enterprise_versioned_docs/version-26.1/troubleshooting_and_faqs/studios_troubleshooting.md +++ b/platform-enterprise_versioned_docs/version-26.1/troubleshooting_and_faqs/studios_troubleshooting.md @@ -2,7 +2,7 @@ title: "Studios" description: "Studios troubleshooting with Seqera Platform." date created: "2024-08-26" -last updated: "2026-08-28" +last updated: "2026-09-21" tags: [faq, help, studios, troubleshooting] --- @@ -215,6 +215,7 @@ If you receive a permission denied error, there are several possible causes: 1. Verify the user has the correct role and permissions in the workspace. 2. Check that the user's SSH public key is configured in their Seqera user profile. 3. Ensure SSH was enabled when adding the Studio using the **SSH Connection** toggle. The SSH setting persists across stop/start but defaults to disabled for new Studios. +4. If some concurrent connections fail while others succeed with the same key, connect one session at a time. If sequential connections succeed, your key and permissions are correct. The concurrent connections exceeded the rate limit for SSH authorization, which the proxy reports as an authentication failure. This applies only when `MICRONAUT_ENVIRONMENTS` includes `ratelim`. To resolve, open fewer connections at the same time, or raise `TOWER_RATELIMIT_PERIOD`. See [Seqera API](../enterprise/configuration/overview#seqera-api) for the rate limit variables. If the issue persists, verify your administrator configured the SSH environment variables during Studios deployment. @@ -244,6 +245,16 @@ Check Studio logs for: The `authorized` field should be `true` and `expected` should equal `incoming`. If they differ, the proxy SSH key configuration is incorrect. +#### SSH command exits with code 255 but no error message + +```bash +ssh alice@a01ac8894@connect.example.com -p 2222 ls /workspace +echo $? +# 255 +``` + +The command completes with full output, but the SSH client exits with code 255 and prints no error. The proxy logs a clean session. This issue occurs when connect-server/proxy version 0.12.1 or 0.12.2 closes the SSH channel before it relays the exit status of the command. Many concurrent connections, or a command that produces no output, make it more likely. Any caller that reads exit codes, such as a script, `scp`, Git over SSH, or VS Code Remote SSH, treats the successful command as a failure. To confirm, check that the output of the command is complete. As a workaround, verify the result of the command before you retry it, because a retry repeats a command that already succeeded. + #### VS Code Remote SSH not working If VS Code fails to connect or shows errors when using the Remote SSH extension, disable local server mode in VS Code settings: