SSHPeaches Support
Need help with SSHPeaches? You’re in the right place. This page covers common setup steps, connection tips, and troubleshooting for the most-used features.
Quick Start
1. Install SSHPeaches from Google Play.
2. Open the app and create a host entry (name, host/IP, port, username).
3. Choose authentication: password, identity key, or both.
4. Tap SSH, SFTP, or SCP on the host card to connect.
FAQs
Does SSHPeaches support password and key authentication?
Yes. You can use password auth, identity key auth, or both (identity first, then password fallback).
Does SSHPeaches support Mosh?
SSHPeaches includes a Mosh option for compatible hosts. Standard SSH remains the default.
What port forwarding modes are supported?
SSHPeaches supports Local forwarding (-L). Remote (-R) and Dynamic (-D) are not supported.
How does SFTP work in SSHPeaches?
SFTP is presented as a command-style workflow, similar to familiar SFTP CLI usage (ls, cd, get, put, etc.).
How does SCP work in SSHPeaches?
SCP uses a dual-pane transfer UI, with transfer activity shown in-session.
Can I run multiple sessions?
Yes, multiple sessions can be active, and you can switch between them in the app.
Are my credentials sent to your servers?
No. Credentials are stored locally on device using Android security primitives. Core operation is local-first.
What happens when the app is in the background?
Background session behavior is configurable in Settings. SSHPeaches keeps a persistent session management notification while sessions run.
Does SSHPeaches include an app lock?
Yes. You can set a PIN and optionally enable biometric unlock with inactivity timeout controls.
Can I import hosts or identities with QR?
Yes. SSHPeaches supports QR-based import/export workflows for portable setup sharing.
I can’t connect. What should I check first?
Make sure that the host, port, username, and login method credentials are correct. In addition, ensure the server allows SSH access from your IP address, and that it supports the auth method you selected.
Which Android versions are supported?
SSHPeaches targets Android 8.0+ (API 26 and above). However, the Google Play version can only be installed on Android 11+ due to policy.
Troubleshooting
Confirm that your username and credentials are correct
Ensure that your server's SSH config allows password or keyfile verification
Authentication Failed
Check your shell's startup scripts (.bashrc or .zshrc) to ensure they aren't exiting immediately.
Verify that your network connection is stable.
Session disconnects quickly
If you are transferring a large file or folder, you might need to disable battery optimization in Android.
File transfer fails
Ensure that the destination host/port is reachable from remote server, the local port is not in use, and you specify a port number greater than 1024.
Port forward not working
Check your server's firewall to make sure the SSH port (22) is allowed through the network.
Connection Refused
Ensure the server is online and reachable from your IP address.
Connection Timed Out
It means you lost network connectivity to the server, and it closed the connection. Just connect again.
Connection Reset By Peer
The fingerprint of the server changed, likely because the operating system was re-installed. Open "Edit Host" for the server and tap "Clear stored host key".
Host Key Verification Failed
Contact Support
If you still need help, contact us at:
When reporting an issue, include:
Device model and Android version
App version
Approximate time and date the error occured
Steps to reproduce
Error message shown in-app
Bug Reports
If you have found a bug in one of our apps, please file a bug report at our Github page.
