telnety.

Getting Started with Telnety

Telnety is a lightweight, cross-platform remote management tool that unifies SSH, RDP, VNC, SFTP, Telnet, and Serial in a single native application. This guide will help you install Telnety, create your first connection, and explore the core features.

Telnety is currently in active development and has not yet launched. This documentation is a preview of what the product will offer. Some features described here may change before release. Join the waitlist for early access.

Installation

Telnety is available for Windows, macOS, and Linux. Choose the installation method that works best for your platform.

Windows

PowerShell
# Install via winget (recommended)
winget install Telnety.Telnety

# Or download the .exe installer from telnety.com/download
# Supports both NSIS (.exe) and MSI (.msi) installers

Linux

bash
# Debian / Ubuntu
sudo dpkg -i telnety_1.0.0_amd64.deb

# Fedora / RHEL
sudo rpm -i telnety-1.0.0-1.x86_64.rpm

# AppImage (any distro)
chmod +x Telnety-1.0.0.AppImage
./Telnety-1.0.0.AppImage

macOS

bash
# Homebrew (recommended)
brew install --cask telnety

# Or download the .dmg from telnety.com/download
# Available for both Apple Silicon (aarch64) and Intel (x86_64)
On macOS, you may need to allow Telnety in System Settings > Privacy & Security if you see a "developer cannot be verified" warning. We are working on getting notarized builds.

Quick Start

Once installed, launch Telnety and you will see the main interface with a sidebar, tab bar, and empty workspace. Here is how to create your first connection in under 30 seconds:

  1. Open Quick Connect — Press Ctrl+K to open the command palette, then type a hostname.
  2. Or use the sidebar — Click the + button in the sidebar to open the New Connection dialog.
  3. Enter connection details — Choose a protocol (SSH, RDP, VNC, etc.), enter the hostname, port, and authentication credentials.
  4. Connect — Click "Connect" or press Enter. Your session opens in a new tab.
Quick Connect (Command Palette)
# Press Ctrl+K (or Cmd+K on macOS) and type:
ssh [email protected]
rdp [email protected]
vnc 10.0.0.5:5901

Your First Connection

Let us walk through creating a saved SSH connection with key-based authentication.

Step 1: Open New Connection

Click the + button in the sidebar or press Ctrl+N. The Host Connection Dialog opens with four tabs: Connection, Authentication, Advanced, and Notes.

Step 2: Fill in Connection Details

On the Connection tab, enter a friendly name (e.g., "Production Web Server"), the hostname or IP, port (default 22 for SSH), and select "SSH" as the protocol.

Step 3: Configure Authentication

Switch to the Authentication tab. Choose "SSH Key" as the auth method, browse to your private key file, or generate a new Ed25519 key pair directly from the dialog.

Step 4: Save and Connect

Click "Test Connection" to verify, then "Save". The host appears in your sidebar. Double-click it to connect at any time.

Configuration

Telnety stores all configuration locally in an SQLite database. You can customize settings through the Settings page (Ctrl+,).

Appearance

Theme, font size, font family, cursor style

Terminal

Scrollback lines, bell, copy-on-select, ligatures

Security

Vault lock timeout, biometric toggle, auto-lock

General

Default shell, startup behavior, language

All settings are stored locally and synced across devices if you have a Pro or Team subscription with Cloud Sync enabled.

Next Steps

Now that you are up and running, explore the protocol-specific guides to learn about advanced features: