hivessh

HiveSsh

Table of Contents

• Table of Contents
• About
• Key Features
• Requirements
• Getting started
• Technologies
• License
• Contributing
• Disclaimer

About

HiveSsh simplifies SSH2 connections via promise-based task execution on Linux servers with built-in server utilities and powerful command execution functions.

HiveSsh is a library designed to streamline SSH2 connections and task execution on Linux servers. It provides user-friendly promise-based functions for efficient server operations without the need for a client application.

Key Features

HiveSsh offers the following key features:

• All-Distributions: SSH2 and SFTP operations for all Linux servers
• Promisified: Promise-based functions for ease of use
• AbstractPackageManager: Built-in abstract package manager with support for apt, dnf, and yum, with additional configurability
• Exec: Command execution utilities for event or promise-based error handling and output parsing, filtering, and mapping

Requirements

HiveSsh requires the following server environments:

• SSH2 server
• SFTP support
• Linux distribution

Getting started

npm i hivessh

import { SshHost } from "hivelib"
// or import SshHost from "hivelib" (SshHost is also the default export)

//connect
const myHost = await SshHost.connect({
    host: "127.0.0.1",
    //port: 22, (default 22)
    //user: "root", (default root)

    //password: "123456789",
    // or
    //privateKey: "..."
    // or
    //privateKeyPath:"/home/user/.ssh/id_rsa",
    //passphrase: "123456789"
})

// check files in user home dir
const result = await myHost.exec("ls -al")
console.log("Result: ", result.out)

// check if a command exists
const gitExist = await myHost.exists("git")
console.log("Git exists: ", gitExist)

// upgrade all packages using the abstract package manager
const apm = await myHost.getApm()
await apm.updateCache()
await apm.upgradeAll()

// install a package using the abstract package manager
await apm.install("git")

Technologies

HiveSsh is built using the following technologies:

• TypeScript
• Node.js
• SSH2

Contributing

Contributions to HiveSsh are welcome!
Interested users can refer to the guidelines provided in the CONTRIBUTING.md file to contribute to the project and help improve its functionality and features.

License

HiveSsh is licensed under the MIT license, providing users with flexibility and freedom to use and modify the software according to their needs.

Disclaimer

HiveSsh is provided without warranties.
Users are advised to review the accompanying license for more information on the terms of use and limitations of liability.