Support
Need Help?
We're here to help you get the most out of NetShell. Find answers to common issues below or reach out directly.
Troubleshooting
Common Issues
Quick fixes for the most frequently reported problems.
Connection Failed
- Check the hostname and port are correct
- Verify the SSH server is running on the remote host
- Ensure your credentials are entered correctly
Authentication Error
- Verify your password or SSH key is correct
- Check the server allows your authentication method
- Try re-entering your credentials in connection settings
Network Scan Empty
- Ensure you are connected to Wi-Fi, not cellular
- Grant local network permission in iOS Settings
- Check Settings > Privacy > Local Network for NetShell
iCloud Not Syncing
- Sign into iCloud on your device
- Check Settings > iCloud > iCloud Drive is enabled
- Ensure NetShell has iCloud access in system settings
AI Not Responding
- Verify your API key is entered correctly
- Check the AI provider's status page for outages
- Try switching to a different AI provider in settings
Widget Not Updating
- Force close and reopen the app
- Check that the server connection is active
- Remove and re-add the widget to your home screen
Before Contacting Support
Update to the latest version from the App Store
Restart the app completely (force close and reopen)
Check your network connection (Wi-Fi or cellular)
Try connecting to a different server to isolate the issue
Get Involved
Help Us Improve
Your feedback shapes the future of NetShell.
Feature Requests
Have an idea that would make NetShell better? We'd love to hear it. Send your feature requests and suggestions to:
Please include a description of the feature and how it would help your workflow. The most requested features get prioritized.
Bug Reports
Found something that isn't working right? Help us fix it quickly by including the following information:
- Your iOS version (e.g., iOS 17.4)
- Your device model (e.g., iPhone 15 Pro)
- Steps to reproduce the issue
- Screenshots or screen recordings if possible
Send reports to support@netshellssh.com