Skip to content

docs: add SSH troubleshooting section for issue #1268#1685

Merged
Milir-Radxa merged 1 commit into
radxa-docs:mainfrom
tangzz-radxa:support/ssh-troubleshooting-v2
Apr 16, 2026
Merged

docs: add SSH troubleshooting section for issue #1268#1685
Milir-Radxa merged 1 commit into
radxa-docs:mainfrom
tangzz-radxa:support/ssh-troubleshooting-v2

Conversation

@tangzz-radxa
Copy link
Copy Markdown
Contributor

Summary

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

Changes

  • docs/common/radxa-os/system-config/_ssh_remote.mdx (+195 lines, CN)
  • i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/system-config/_ssh_remote.mdx (+195 lines, EN)

Troubleshooting Content

  1. SSH service status verification
  2. Network connectivity checks (ping test)
  3. Firewall diagnostics (nftables/iptables)
  4. Password authentication configuration
  5. Common error messages and their meanings
  6. Windows SSH client troubleshooting
  7. Public key permission issues
  8. SSH configuration reset with safety warning
  9. GitHub Issue submission guidance

Verification

  • Both CN and EN versions updated
  • Commands verified for Radxa OS environment
  • bilingual check: both files modified with equivalent content

Closes #1268

Add comprehensive SSH troubleshooting guide covering:
- SSH service status verification
- Network connectivity checks
- Firewall (nftables/iptables) diagnostics
- Password authentication configuration
- Common error messages and solutions
- Windows SSH client troubleshooting
- Public key permission troubleshooting
- SSH configuration reset with safety warning
- GitHub Issue guidance

Addresses connection failures reported in issue radxa-docs#1268.
@Milir-Radxa Milir-Radxa merged commit efef03f into radxa-docs:main Apr 16, 2026
4 of 6 checks passed
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.

Issue from cubie/a7z/system-config/ssh-remote

2 participants