Skip to main content

Retrieve a stable server to deploy

Project description


Build status License

This tool is used to retrieve stable servers from various services.


The package is uploaded to In order to install the package you should use pip:

pip install getserv

python >= 3.6 is required

Basic usage

Basically the driver is responsible for delivering the ips to the main program. The main program will just scan all the ips received from the driver and checks whether a service on a given port is available:

getserv [...args] {driver_name} [...args]

Changing the port to scan

The default port is 22. You may change it with the --test-port (-p) option.

Listing all IPs

The default beheavior is to only return one address. You can list all available server IPs by adding the --list-all (-a) option.

The DigitalOcean driver

The digitalocean driver is used to filter droplets by multiple tags. Since the doctl can only filter by single tags, the driver will fallback to the REST API. It'll get information for the requested droplets and filters by the given tags. In order to get a running droplet from your droplet stack you execute this:

getserv digitalocean tag1,tag2

To authenticate yourself you can use either a cli argument or a environemt variable:

getserv digitalocean \
  --digitalocean-access-token XXXXXXXXXXX \

Or to use the environment varible:

getserv digitalocean tag1,tag2

If everything is configured properly you should receive a single IP based on the availability of your droplets


See the LICENSE file for license rights and limitations (MIT).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

getserv-0.0.4.tar.gz (3.9 kB view hashes)

Uploaded source

Built Distribution

getserv-0.0.4-py3-none-any.whl (6.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page