LogoLogo
  • Pear by Holepunch
  • Pear runtime
    • Command-Line-Interface (CLI)
    • Application-Programming-Interface (API)
    • Application Configuration
    • Troubleshooting Applications
  • Bare reference
    • Overview
    • Application-Programming-Interface (API)
    • Node.js Compatibility with Bare
    • Bare Modules
    • Troubleshooting with Bare
  • Guides
    • Getting Started
    • Starting a Pear Desktop Project
    • Making a Pear Desktop Application
    • Starting a Pear Terminal Project
    • Making a Pear Terminal Application
    • Sharing a Pear Application
    • Marking a Release
    • Making a Bare Mobile Application
    • Debugging a Pear Terminal Application
    • Creating a Pear Init Template
  • Building blocks
    • Hypercore
    • Hyperbee
    • Hyperdrive
    • Autobase
    • HyperDHT
    • Hyperswarm
  • How-tos
    • Connect two peers
    • Connect many peers
    • Replicate & persist
    • Manage multiple Hypercores
    • Share append-only databases
    • Create a p2p filesystem
  • Helpers
    • Corestore
    • Localdrive
    • Mirrordrive
    • Secretstream
    • Compact encoding
    • Protomux
  • Tools
    • Hypershell
    • Hypertele
    • Hyperbeam
    • Hyperssh
    • Drives
  • Apps
    • Keet
  • Examples
    • Bare on Mobile
    • React App using Pear
Powered by GitBook

Copyright © 2024 - 2025 Holepunch, S.A. de C.V. All rights reserved.

On this page
  • Installation
  • Basic usage
  • Windows RDP
  • The hyper-cmd system
  1. Tools

Hyperssh

Last updated 1 year ago

A utility to facilitate SSH operations via the .

Installation

Install with :

npm install -g hyperssh // ssh / fuse client stubs
npm install -g hypertele // hyperswarm server proxy
npm install -g hyper-cmd-utils // keygen utils

Basic usage

On a server or a machine running an ssh-server, run:

hyper-cmd-util-keygen --gen_seed
-> SEED

hypertele-server --seed SEED -l 22
-> PEER_KEY

This will start announcing the server on the DHT and will display the Noise Public Key of the server.

To connect to the server from another machine, pass the keypair to the hyperssh command, along with an optional username:

hyperssh -s ab01f... -u maf
hyperssh -s ab01f... -u maf -i keypair.json

There is no need to remember hostnames any more.

Under the hood, Hyperswarm performs UDP holepunching. So the server should be accessible even if it is located on a home network. Refer to identity management for more information.

Windows RDP

Hyperssh can also be used with Windows RDP to remotely log in to Windows machines over Hyperswarm.

Ensure RDP is enabled on the computer that is going to be logged into (the server), and on that computer run:

hypertele-server --seed SEED -l 3389

Then on another computer (client), anywhere on the internet, ssh into the server:

hyperssh --rdp -s ...

The hyper-cmd system

The Hyperssh also supports the hyper-cmd system. Refer to and for additional information.

Identity management
Host resolution
HyperDHT
GitHub (Hyperssh)
npm
Installation
Basic usage
Windows RDP