srvctl Servers.com

bare-metal cli cloud-server golang servercom

Use this command to install srvctl:

winget install --id=ServersCom.srvctl -e

srvctl is a command-line client designed to manage infrastructure on Servers.com directly from the terminal. Built using Go, it provides a fast and scriptable interface for interacting with Servers.com’s bare-metal servers, cloud services, and other products.

Key Features:

A robust CLI tool that wraps the Servers.com Public API.
Support for multiple contexts to manage different accounts or API endpoints within a single installation.
Configuration options allowing users to customize settings such as proxy, timeout, verbosity, and output format (text, JSON, YAML).
Comprehensive documentation accessible via man pages or the --help flag.

Audience & Benefit: Ideal for system administrators and DevOps engineers who require efficient management of Servers.com infrastructure. By providing a unified command-line interface, srvctl simplifies operations and improves scriptability, enabling users to automate tasks without switching tools or platforms.

Installable via winget, srvctl offers seamless integration into existing workflows, making it an essential tool for managing cloud and bare-metal resources efficiently.

srvctl - CLI for Servers.com infrastructure

Description

Manage your Servers.com bare metal servers, cloud servers, and infrastructure directly from the terminal.

srvctl wraps the Servers.com Public API into a fast, scriptable command-line interface built in Go.

Quick Start

Homebrew (macOS & Linux):

brew tap serverscom/serverscom
brew install srvctl

Docker:

docker pull ghcr.io/serverscom/srvctl:latest
docker run --rm -it ghcr.io/serverscom/srvctl:latest --help

Binary releases:

Download the latest release for your OS and architecture from the Releases page.

Usage

Authentication

Create a context with your Servers.com API token:

$ srvctl login default 
Enter API token: *****

Successfully logged in with context "default"
Context "default" set as default

Configuration

The config file is stored at $XDG_CONFIG_HOME/srvctl/config.yaml, if XDG_CONFIG_HOME exists. Otherwise it will rely on $HOME/.config/srvctl/config.yaml. You can override this with the SRVCTL_CONFIG_PATH environment variable.

srvctl supports multiple contexts, allowing you to manage several Servers.com accounts or API endpoints from a single installation:

globalConfig: {}
defaultContext: default
contexts:
    - name: default
      endpoint: https://api.servers.com/v1
      token: 
      config: {}
    - name: different-context
      endpoint: https://api.servers.com/v2
      token: &lt;2ND_API_TOKEN&gt;
      config: {
        proxy: "",
        http-timeout: 30,
        verbose: true, /* (true|false) */
        output: "json" /* (text|json|yaml) */
      }

You can adjust the context later on:

# changing the context name
srvctl context update  --name=

# setting context to act as default
srvctl context update  --default

# delete specific context
srvctl context delete

Documentation

Documentation is accessible via or via flag, for example: