Warp documentation
  • Getting Started
    • Quickstart Guide
    • What is Warp?
    • Supported shells
    • Migrate to Warp
    • Keyboard Shortcuts
    • Changelog
  • Agents
    • Warp AI
      • Agent Mode
    • Active AI
    • Generate
    • Voice
  • Terminal
    • Appearance
      • Themes
      • Custom Themes
      • Prompt
      • Input Position
      • Text, Fonts, & Cursor
      • Size, Opacity, & Blurring
      • Pane Dimming & Focus
      • Blocks Behavior
      • Tabs Behavior
      • App Icons
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • Block Find
      • Block Filtering
      • Background Blocks
      • Sticky Command Header
    • Modern Text Editing
      • Alias Expansion
      • Command Inspector
      • Syntax & Error Highlighting
      • Vim Keybindings
    • Command Entry
      • Command Corrections
      • Command Search
      • Command History
      • Synchronized Inputs
      • YAML Workflows
    • Command Completions
      • Completions
      • Autosuggestions
    • Command Palette
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
      • SSH Legacy
    • More Features
      • Accessibility
      • Files, Links, & Scripts
      • Markdown Viewer
      • Working Directory
      • Smart-Select
      • Full-screen Apps
      • Notifications & Audible Bell
      • Settings Sync (Beta)
      • Quit Warning
      • URI Scheme
      • Linux
    • Comparisons
      • Performance
      • Terminal features
    • Integrations
  • Knowledge & Collaboration
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
    • Model Context Protocol
    • Rules
    • Teams
    • Session Sharing
  • Privacy
    • Privacy
    • Secret Redaction
    • Network Log
  • Community
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
  • Support & Billing
    • Sending Feedback & Logs
    • Plans & Pricing
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • FAQs
  • Do I have to manually Warpify every time?

Was this helpful?

  1. Terminal
  2. Warpify

SSH

SSH wrapper that enables Warp features in remote sessions.

PreviousSubshellsNextSSH Legacy

Last updated 3 days ago

Was this helpful?

This page is dedicated to the upcoming SSH features that may not yet be available to you, powered by tmux.

If you are looking to troubleshoot the legacy SSH implementation, see the .

Warpifying your SSH session gives you all the features of Warp while connected to a remote machine: the input editor, auto-completions, history search, and more. We achieve this by running commands like ls on the remote machine on your behalf.

Warpifying a remote SSH Session .

FAQs

Will Warpifying a remote SSH session make changes to the remote machine?

Why do I need tmux on the remote machine?

Can I ssh to remote machines that I don't want to Warpify?

Yes! You can always cancel Warpification and continue to use SSH, just without some of Warp's additional features. You can also explicitly add hosts to the Denylist to ensure you’re never asked to Warpify that host again.

Do I have to manually Warpify every time?

After you successfully Warpify an SSH connection manually, we provide a brief script you can run to append a message at the end of your shell's rcfile. This allows us to know when your shell is ready to be Warpified, and be found at the bottom of your rcfile for the best results.

What shells and operating systems are supported?

At the time of writing, we support macOS and most flavors of Linux as remote hosts. Supported shells are bash and zsh.

What if Warp fails to detect my SSH session?

What triggers SSH Session Detection for Warpification?

If SSH Session Detection is enabled, Warp will detect when you run an ssh command with arguments that suggest it's starting an interactive session. If you've aliased ssh or are running it as part of a script, we will not perform SSH Session Detection.

Once we have confidence you have successfully authenticated (by detecting Last login: or something resembling a basic prompt) we will prompt you to Warpify your active SSH session.

Only to install (a popular open source terminal multiplexer) and only with your explicit permission. If tmux is not installed, Warp will offer to install it for you and will show you the list of commands that will be run. You can always decline and continue to use your ssh session without some of Warp's features (or install tmux yourself and re-run Warpification ).

tmux is used to asynchronously run commands on the remote machine without disrupting your interactive session. is a popular open source terminal multiplexer, which lets you run multiple sessions within one ssh connection. It requires minimal permissions and is widely adopted (⭐ 35k+ on GitHub). Warpifying a remote SSH session uses to run adhoc background tasks (like those required to autocomplete a cd command, or populate the contents of a custom prompt).

If you are ever in a remote SSH Session and would like to manually Warpify, you can do so by using the and searching for "Warpify SSH Session".

If SSH Session Detection does not detect your session, you can still .

tmux
tmux Control Mode
Command Palette
tmux
via the command palette
Warpify manually
SSH (Legacy)
will never make lasting changes to the remote machine without your explicit consent
SSH
Setting up Auto-Warpify