5-Minute Quickstart

From Zero to Connected

Ready to ditch your old terminal? Let's get you set up.

Installation

Download the latest release for your OS from GitHub Releases.

  • macOS: Drag .app to Applications. Run xattr -cr /Applications/Netcatty.app if Gatekeeper complains.
  • Windows: Run the installer.
  • Linux: AppImage or .deb.

Instead of typing your password for every server, let's create a reusable Identity.

  1. Go to the Keychain tab.
  2. Click +.
  3. Name it "My SSH Key".
  4. Select your private key file (usually ~/.ssh/id_ed25519).

Add Your First Host

Go to the Hosts tab.

  1. In the Search/Connect bar at the top, type user@your-server-ip.
  2. Watch as the Zap icon appears (Smart Connect).
  3. Press Enter or click Connect. Netcatty will open the Quick Connect wizard and ask if you'd like to save this host.

Split the View

Once connected:

  1. Right-click the terminal tab.
  2. Select Split Right.
  3. Choose the same host (or a different one) to open a side-by-side view.

Next Steps

Now that you're connected, check out:

Installation & Setup

Comprehensive guide for deploying Netcatty across all platforms

Host Management (The Vault)

Master the art of organizing infrastructure with the Netcatty Vault

On this page

InstallationCreate an Identity (Optional but Recommended)Add Your First HostSplit the ViewNext Steps