Support
We're here to help you get the most out of KumaSH.
Frequently Asked Questions
How do I add SSH keys to KumaSH?
You can generate a new SSH key pair directly within the App or import an existing private key. Go to Settings > SSH Keys to manage your keys. KumaSH supports Ed25519 and RSA key types. All keys are stored securely in the iOS Keychain.
What SSH key formats are supported?
KumaSH supports OpenSSH format private keys, including Ed25519, RSA (2048-bit and above), and ECDSA. PEM and OpenSSH key formats are both accepted. Passphrase-protected keys are supported.
How does MOSH work in KumaSH?
MOSH (Mobile Shell) provides persistent connections that survive network changes. To use MOSH, your remote server must have mosh-server installed. KumaSH will first establish an SSH connection to start the MOSH server, then switch to the UDP-based MOSH protocol. Your session persists even when switching between Wi-Fi and cellular, or when your device sleeps.
Do I need to install MOSH on my server?
Yes. MOSH requires mosh-server to be installed on your remote server. On Ubuntu/Debian, you can install it with sudo apt install mosh. On macOS, use brew install mosh. Ensure your firewall allows UDP ports 60000-61000.
How does the Claude Code AI integration work?
KumaSH provides a native chat interface for Anthropic's Claude Code. The AI assistant connects through your SSH session, meaning Claude Code runs on your remote server via the SSH tunnel — not directly from your device. This ensures your data stays within your infrastructure. You need Claude Code set up on your server for this feature to work.
Is my data secure?
Yes. All SSH credentials are stored in the iOS Keychain with hardware-backed encryption. Terminal session content, commands, and AI conversations are never transmitted to Kumalabs servers. SSH connections use standard encryption protocols. See our Privacy Policy for full details.
Can I use KumaSH with jump hosts / bastion servers?
Yes. KumaSH supports SSH jump host (ProxyJump) configurations, allowing you to connect through intermediate bastion servers to reach your target host.
Does KumaSH support port forwarding?
Yes. KumaSH supports both local and remote port forwarding, allowing you to tunnel traffic through your SSH connection securely.
What iOS version is required?
KumaSH requires iOS 17.0 or later. It is compatible with both iPhone and iPad.
I found a bug. How do I report it?
Please report bugs via our GitHub Issues page or email support@kumalabs.vn. Include your iOS version, device model, and steps to reproduce the issue.