Skip to content

Latest commit

 

History

History
117 lines (81 loc) · 3.54 KB

installation.md

File metadata and controls

117 lines (81 loc) · 3.54 KB

Installation Guide

This guide provides detailed instructions for installing NodePass using different methods. Choose the option that best suits your environment and requirements.

System Requirements

  • Go 1.24 or higher (for building from source)
  • Network connectivity between server and client endpoints
  • Admin privileges may be required for binding to ports below 1024

Installation Options

Option 1: Pre-built Binaries

The easiest way to get started with NodePass is to download a pre-built binary for your platform.

  1. Visit the releases page on GitHub
  2. Download the appropriate binary for your operating system (Windows, macOS, Linux)
  3. Extract the archive if necessary
  4. Make the binary executable (Linux/macOS): 
    chmod +x nodepass
  5. Move the binary to a location in your PATH:
    • Linux/macOS: sudo mv nodepass /usr/local/bin/
    • Windows: Add the location to your PATH environment variable

Option 2: Using Go Install

If you have Go installed on your system, you can use the go install command:

go install github.com/yosebyte/nodepass/cmd/nodepass@latest

This command downloads the source code, compiles it, and installs the binary in your Go bin directory (usually $GOPATH/bin).

Option 3: Building from Source

For the latest development version or to customize the build:

# Clone the repository
git clone https://github.com/yosebyte/nodepass.git

# Navigate to the project directory
cd nodepass

# Build the binary
go build -o nodepass ./cmd/nodepass

# Optional: Install to your GOPATH/bin
go install ./cmd/nodepass

Option 4: Using Container Image

NodePass is available as a container image on GitHub Container Registry, perfect for containerized environments:

# Pull the container image
docker pull ghcr.io/yosebyte/nodepass:latest

# Run in server mode
docker run -d --name nodepass-server -p 10101:10101 -p 8080:8080 \
  ghcr.io/yosebyte/nodepass server://0.0.0.0:10101/0.0.0.0:8080

# Run in client mode
docker run -d --name nodepass-client \
  -e MIN_POOL_CAPACITY=32 \
  -e MAX_POOL_CAPACITY=512 \
  -p 8080:8080 \
  ghcr.io/yosebyte/nodepass client://nodepass-server:10101/127.0.0.1:8080

Option 5: Using Management Script (Linux Only)

For Linux systems, we provide an interactive management script for easy installation and service management:

bash <(curl -sL https://cdn.yobc.de/shell/nodepass.sh)

This script provides an interactive menu to:

  • Install or update NodePass
  • Create and configure multiple nodepass services
  • Manage (start/stop/restart/delete) nodepass services
  • Set up systemd services automatically
  • Configure client and server modes with customizable options

Verifying Installation

After installation, verify that NodePass is correctly installed by checking the version:

nodepass

np-cli

Next Steps

Now that you have NodePass installed, you can:

Troubleshooting Installation Issues

If you encounter any issues during installation:

  • Ensure your system meets the minimum requirements
  • Check that you have the correct permissions to install software
  • For Go-related issues, verify your Go installation with go version
  • For container-related issues, ensure Docker is properly installed and running
  • See our troubleshooting guide for more help