Help
Browse topics for getting started with Secure ShellFish, the SSH and SFTP client for iPhone, iPad and Mac. Each topic mirrors a section of the in-app help with extra detail for the web.
Terminal
Agentic Coding
Tools like Claude Code, the Codex CLI and OpenCode stay running for many minutes. Location Persistence, dictation and Picture in Picture make Secure ShellFish a comfortable home for them.
Cursor and Selection
Move the cursor and select text in the terminal — arrow keys, drag near the cursor, on-screen arrows, three-finger pinch, and Magic Trackpad pan.
SSH Terminal
Open shell sessions and run commands on your iPhone, iPad or Mac with native rendering, file-aware drag-and-drop, OSC 52 clipboard sync and inline link detection.
Terminal Multiplexing
Use tmux to keep terminal sessions alive while you switch apps and devices, with Handoff between Apple devices, universal-link sharing and session thumbnails.
Terminal Snippets
Snippets for commonly used commands with control codes, delays, #Tag filtering and a curated gallery — synced across your devices via iCloud Keychain.
Setup
Adding Servers
Connect to SSH and SFTP servers with password, public key or two-factor authentication, and use comma-separated hostnames for failover between local and remote networks.
Connect to Windows
Install OpenSSH on Windows as an Optional Feature, start the sshd service, and connect to the IPv4 address shown in network settings.
Files app
Connect SSH and SFTP servers to the iOS Files app and Mac Finder. Browse, edit in-place, set permissions, and pin files for offline use.
Spin Up VMs
Launch Linux virtual machines on Digital Ocean droplets or Hetzner Cloud and destroy them when no longer needed to control spend.
SSH Keys
Public-key authentication with ED25519, ECDSA and RSA keys. Generate keys on the Secure Enclave, use a YubiKey, or sign in with short-lived certificates from your CA.
Use with your Mac
Make your Mac a server for Secure ShellFish: enable Remote Login from System Settings → General → Sharing.
Features
Instant Playback
Stream audio and video from the server without waiting for the download to finish, with byte-range seeking, Picture in Picture and Handoff.
Offline folders
Mark directories for offline use so files are available when the server is out of reach. Foreground + background sync with resume and failure notifications.
Quick Upload
Upload from any app via the share sheet. Per-file-type target directory memory, multi-file queueing, and folder upload from iCloud Drive or Working Copy.
Server Import
Import many servers from ~/.ssh/config or CSV files in one pass, with field auto-detection and ID-based update / delete on re-import.
Shortcuts automation
Automate Secure ShellFish from the Shortcuts app — Upload, Download, List Directory, Run Command, Get Path, Stat, Move, Delete, Backup, Start Terminal.
Widgets
Configure Home Screen, Lock Screen, StandBy and Apple Watch widgets driven from your server with a single shell command, plus Live Activities for ongoing tasks.