Skip to content

docs: add SSH troubleshooting section based on issue #1268#1595

Open
tangzz-radxa wants to merge 1 commit intoradxa-docs:mainfrom
tangzz-radxa:support/issue-1268-ssh-troubleshooting
Open

docs: add SSH troubleshooting section based on issue #1268#1595
tangzz-radxa wants to merge 1 commit intoradxa-docs:mainfrom
tangzz-radxa:support/issue-1268-ssh-troubleshooting

Conversation

@tangzz-radxa
Copy link
Copy Markdown
Contributor

Summary

Add comprehensive SSH troubleshooting section to address common connection issues reported in issue #1268.

Why

Issue #1268 reported SSH authentication failures even with correct credentials. The current SSH documentation lacks troubleshooting guidance for common connection problems. This update provides step-by-step troubleshooting for:

  • SSH service status and configuration issues
  • Firewall and network connectivity problems
  • Common authentication errors
  • Windows SSH client specific issues
  • SSH configuration reset procedures

Verification

  1. Both Chinese (docs/common/radxa-os/system-config/_ssh_remote.mdx) and English (i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_ssh_remote.mdx) versions have been updated
  2. The troubleshooting section covers all common issues reported in the GitHub issue
  3. The changes are minimal and focused only on adding troubleshooting guidance
  4. All commands have been tested and verified as correct
  5. The bilingual check passes (both Chinese and English versions updated)

This PR addresses the documentation gap identified in issue #1268 and provides users with actionable steps to diagnose and resolve SSH connection problems.

Add comprehensive troubleshooting guide for SSH connection issues including:
- SSH service status checks
- Configuration verification
- Firewall settings
- Common issues and solutions
- Windows client troubleshooting
- SSH reset procedures

This addresses common SSH authentication problems reported by users and provides step-by-step guidance for diagnosis and resolution.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant