Ruby SDKs

Use the IONOS CLOUD Ruby SDKs to build Ruby apps on IONOS CLOUD. Each SDK is published as a RubyGem.

Available Ruby SDKs

Core Infrastructure

Cloud API Ruby SDK

Manage compute, networking, storage, and all core IONOS CLOUD resources

Database

DBaaS Mongo Ruby SDK

Provision and manage managed MongoDB clusters

DBaaS Postgres Ruby SDK

Provision and manage managed PostgreSQL clusters

Containers and Compute

Container Registry Ruby SDK

Manage container registries and image repositories

VM Autoscaling Ruby SDK

Configure and manage autoscaling groups for virtual machines

Security

Certificate Manager Ruby SDK

Manage TLS/SSL certificates for IONOS CLOUD services

Quick Start

Add the Cloud API Ruby SDK to your Gemfile:

gem 'ionoscloud'

Then run:

bundle install

Or install directly:

gem install ionoscloud

Configure and initialise a client:

require 'ionoscloud'

Ionoscloud.configure do |config|
  config.username = ENV['IONOS_USERNAME']
  config.password = ENV['IONOS_PASSWORD']
end

api_instance = Ionoscloud::DataCentersApi.new

For token-based authentication:

Ionoscloud.configure do |config|
  config.token = ENV['IONOS_TOKEN']
end

Authentication

All Ruby SDKs use the same credentials. Store them in environment variables and keep them out of your source code.

export IONOS_USERNAME=[e-mail]
export IONOS_PASSWORD=yourpassword

# Preferred for CI/CD and automation:
export IONOS_TOKEN=your_api_token

GitHub Repositories

All Ruby SDKs are open source under the ionos-cloud organisation on GitHub. They are published to RubyGems.org and follow the naming convention ionoscloud-{service} for product SDKs.