Saved Connections

Bookmark and Manage Your Remote SSH Hosts

Re-typing hostnames, IP addresses, usernames, and custom SSH ports on a mobile touchscreen is inefficient and prone to typos. Casshper's Saved Connections allows you to store, organize, and launch SSH server profiles with a single tap.

Creating a Saved Connection

1. Open Casshper and open the sidebar menu to view your Saved Connections. Tap the + icon next to "Saved Connections" (or select Connection Manager) to open the connection dialog.
2. Configure your SSH connection parameters:
   • Connection Name: Set a friendly display label (e.g., My Server or Staging DB).
   • Username: Enter your remote SSH username (e.g., ubuntu or root).
   • Hostname / IP: Enter the target domain name or IP address (e.g., 192.168.1.50 or api.example.com).
   • Port: Specify the remote SSH port (default: 22).
   • SSH Key: Select an existing key, tap Import to choose a key file, or select None (Password) for password authentication.
   • Server-Specific Theme (Pro Admin): Assign a dedicated terminal color theme directly to this host profile. Tap the theme selector card to browse 450+ bundled themes with live palette swatches. When set, connecting to this host automatically themes your session (e.g. Solarized Red for production or Nord for development).
   • GLOBAL Default Badge and Reset: When no server theme is explicitly set, the selector displays a compact GLOBAL badge indicating that it inherits the global default theme from Terminal Settings. Tap RESET at any time to clear a custom theme and restore the global default.
3. Tap Save. Your new connection appears immediately in your saved connections list.

Server-Specific Color Themes (Pro Admin)

Preventing catastrophic mistakes on production machines requires immediate visual clarity. With Casshper Pro Admin, each saved connection can be styled with its own persistent palette:

• Automatic Theming on Connect: Launching a saved connection immediately initializes the Ghostty GPU terminal canvas with that host's assigned theme—no manual toggling required.
• 14-Color Swatch Preview: The connection editor displays a dual-row color preview (light/bright shades on top, standard/dark shades on bottom) alongside the theme name.
• Theme Preview Picker Modal: Tap the theme selector to open the Theme Preview Picker modal, allowing you to search through 450+ bundled Ghostty palettes and see live terminal color previews before saving.
• Inheritance and Overrides: Connections marked with the GLOBAL badge follow your global theme setting. If you change your global theme, all global-badged connections update automatically, while servers with custom themes stay locked to their assigned colors.

Learn more about dynamic runtime session theming in Contextual Themes.

Managing Saved Connections

Tap a connection name in the sidebar to launch an SSH session immediately. Tap the options menu icon next to any connection (or tap a host inside Connection Manager) to open its management menu:

• Connect: Launch an active terminal session immediately.
• Mount / Unmount (Pro Admin): Mount the remote server's filesystem into Android's native Files app drawer over SFTP.
• Start / Stop Forwarding (Pro Admin): Activate or deactivate background SSH port forwarding tunnels.
• Manage Ports (Pro Admin): Configure local (-L) or remote (-R) SSH port forwarding rules for that host.
• Edit / Delete: Update host credentials or remove outdated server bookmarks.