Master your
Workflow.
KnoticSSH is built to be intuitive, but its true power lies in the details. Learn how to optimize your infrastructure management.
Getting Started
Download the .dmg or .exe from our home page. KnoticSSH is a standalone application that requires no installation of heavy background services.
- macOS: Open the DMG and drag to Applications. Right-click and select "Open" for the first time.
- Linux: Use the provided AppImage or build from source in our private repo.
Vault Security
Security is the core of KnoticSSH. On your first launch, you must set a Master Password. This password is used as the key for your local AES-256-CFB encryption vault.
If you lose your Master Password, your data is lost forever. We have no "Reset Password" feature because we do not have access to your data.
Organizing Servers
Don't let your server list become a mess. KnoticSSH allows you to group servers into logical folders:
Logical Groups
Categorize by Project (e.g., "E-Commerce"), Environment ("Staging"), or Region.
Search & Filter
Instantly find servers by IP, hostname, or custom nicknames.
Sync & Catalog
Setting up your entire infrastructure should take seconds, not hours. KnoticSSH provides robust Import and Export capabilities for rapid deployment.
Have your hosts in a spreadsheet? Export them to CSV and upload them directly. We support automatic column mapping to match your format.
Export your entire configuration (excluding vault secrets) as a structured JSON file. Perfect for sharing server lists with your team.
Sharing Workflow
Go to Settings or the Sidebar and click "Sync & Catalog".
Share the resulting file with your teammates.
They click "Import CSV", upload the file, and BOOM—full host list ready in a second.
Responsive Tab Bar
Version v1.2.0 introduces a completely redesigned session management system. Work with dozens of active terminals simultaneously without losing your place.
Horizontal Scrolling
Session tabs now live in a horizontal scroll area. No more "overflow" menus that hide your work. Just swipe or scroll to find any session instantly.
Intelligent Auto-Scroll
When you switch between sessions or open a new one, the application automatically scrolls the active tab into view, keeping your focused terminal centered.
Tip:Action buttons like "Shield Lock" and "Resync" stay pinned to the right, ensuring security tools are always one click away.
SSH & Connections
Connecting is simple. Click "Add New Server" and fill in the details:
Credential Vault
Tired of re-typing passwords? Use the Vault. Save a specific set of credentials (username/password or username/key) once, and link it to multiple servers. When you update the vault, all linked servers are updated automatically.
VPN Management
Accessing servers behind a private network? KnoticSSH integrates directly with the most common VPN protocols, eliminating the need for separate client apps.
Supported Protocols
- OpenVPN — Full support for .ovpn profiles.
- FortiClient — SSL-VPN support via openfortivpn.
- PPTP / L2TP — Native integration (macOS).
One-Click Install
Missing a binary? Click "Test Configuration" in the app. KnoticSSH will detect missing tools and offer to install them via Homebrew or Winget automatically.
How to Connect
- Go to the Network tab in the sidebar.
- Click "Add VPN" and select your protocol.
- Upload your configuration file or enter the gateway address.
- Once saved, hit the Connect button. Logs will stream in real-time to help you debug any issues.
Quick Actions
The Quick Actions menu is a developer's best friend. It allows you to store and execute complex, multi-line shell commands with a single click.
Common Developer Snippets
docker system prune -af --volumesgit branch -D $(git branch --merged)php artisan migrate:fresh --seedtail -f storage/logs/laravel.logOrganize snippets by project or stack (e.g., "Laravel", "React", "K8s"). Use the instant search bar to find commands in milliseconds.
Standardize your team's workflows. Export your snippet library as a JSON file and share it with your teammates for instant setup.
Keyboard Shortcuts
Speed up your workflow with our non-colliding system shortcuts. These are designed to avoid conflicts with standard browser or OS reserved keys.
Pro Tip:In the terminal, Ctrl + C now behaves intelligently. If you have text selected, it copies it. If no selection exists, it sends the standard SIGINT to your remote process.
Developer Features
Developer Shell Link
Bridge the gap between your local system and remote environments.
The Developer Shell feature allows you to open a native local terminal session directly within KnoticSSH. This is perfect for running local build tools, environment checks, or git operations without leaving your management workspace.
Instant Access
Use the sidebar link or shortcut to jump into a local shell instantly.
Context Aware
Easily toggle between remote SSH sessions and your local environment.
Cross Platform
Supports Zsh, Bash, and PowerShell depending on your OS.
PRO TIP: Use Cmd + Shift + D / Ctrl + Shift + D to spawn a Developer Shell from any view.
Smart Editor (KnoticEditor)
A high-performance modern editor integrated directly into your SSH workflow.
The editor uses custom OSC 520 escape sequences to securely bridge remote files to your local GUI without needing SFTP or complex setups.
Instant Activation
Press Cmd + E / Alt + E to activate shell features. This allows you to use the kedit [file] command to open any server file in a beautiful GUI editor instantly.
Theme & UI
The editor automatically adopts your terminal's theme for a consistent experience. It features full syntax highlighting, bracket matching, and a distraction-free mode.
Smart Paste
Handling large chunks of code? The editor uses "Paced Injection" to paste code into your terminal without overwhelming buffers or breaking auto-indentation.
Find Everything
Includes a native search power. Press Cmd + F / Ctrl + F within the editor to search through massive log files or configuration code with ease.
Version History
Track the evolution of KnoticSSH. We strictly use Semantic Versioning to indicate the scale of changes:
New Features
- Smart Editor integration with enhanced code and terminal editing capabilities.
- Improved import and export functionality for easier migration of server data and settings.
- Added system reset mechanism to restore the application to a 'like new' state.
Improvements
- Enhanced host group deletion logic and management.
- Integrated role selection features for work roles.
- Improved password reset and recovery workflows.
Bug Fixes
- Fixed password formatting issues during reset operations.
Added
- Redesigned Horizontal Responsive Tab Bar for improved session navigation.
- Native VPN management support added for OpenVPN and FortiClient without third-party GUIs.
- Quick Actions feature fully implemented for faster command execution.
Fixed
- Resolved issue where host passwords were not saving correctly.
- Improved credential handling stability within the Vault.
- Minor UI and performance optimizations.
Security & Management Update
- Introduced Host Group List for organized server management.
- Launched secure Credential Vault for storing SSH credentials.
- Added CSV import and export functionality for host data.
- Implemented PIN code login for quick and secure access.
- Enabled biometric authentication support (Fingerprint / Face ID).
- Enhanced overall vault protection with AES-256-CFB encryption.
Genesis
- Knoticssh officially launched.
- Basic SSH connect command introduced.
- Initial server connection support added.
- Limited feature set available in this release.
- Foundation for future session and server management established.
On the Way
We are constantly building. Here is a sneak peek at our roadmap. Note that dates and features in this section are Subject to Change:
Secure Cloud & Portability (Optional)
- Optional Secure Cloud Sync for Hostlist and Profile Data.
- End-to-End Encrypted multi-device synchronization.
- Zero-knowledge architecture — data is encrypted locally before upload.
- User-controlled encryption keys derived from master password.
- Full Profile Export (Hosts, Groups, Vault, Settings) for seamless offline migration.
- Local-Only mode enabled by default for maximum privacy.
Intelligent Assistance
- Introducing Knotic AI — a lightweight, local assistant that learns your workflow over time.
- Smart command suggestions based on your past activity.
- Automatic workflow recognition for repetitive server tasks.
- Predictive next-step recommendations during SSH sessions.
- Shadow Preview mode with safe approval before execution.
Privacy & Control
- All intelligence runs locally on your device.
- No command history is sent to external servers.
- Fully private learning engine designed for infrastructure teams.
Still need help?
We are a small, dedicated team in Nepal. Reach out directly for support or to suggest a feature.