# 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

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Cloud API Ruby SDK</strong></mark></td><td>Manage compute, networking, storage, and all core IONOS Cloud resources</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/-MUON6CaF6Z_AbPKaHEF-3956399747/">Cloud API Ruby SDK</a></td></tr></tbody></table>

#### Database

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>DBaaS Mongo Ruby SDK</strong></mark></td><td>Provision and manage managed MongoDB clusters</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/ezEstSumfqUQgj0e1pRT/">DBaaS Mongo Ruby SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>DBaaS Postgres Ruby SDK</strong></mark></td><td>Provision and manage managed PostgreSQL clusters</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/Gsqc61FzKZqg8eYVUSJX/">DBaaS Postgres Ruby SDK</a></td></tr></tbody></table>

#### Containers and Compute

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Container Registry Ruby SDK</strong></mark></td><td>Manage container registries and image repositories</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/Gd5qx4t4MSCvowww3Han/">Container Registry Ruby SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>VM Autoscaling Ruby SDK</strong></mark></td><td>Configure and manage autoscaling groups for virtual machines</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/M6pVFHUfKpLYigU1sFxu/">VM Autoscaling Ruby SDK</a></td></tr></tbody></table>

#### Security

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Certificate Manager Ruby SDK</strong></mark></td><td>Manage TLS/SSL certificates for IONOS Cloud services</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/0qn3ANH4qjRMlTjC6uWZ/">Certificate Manager Ruby SDK</a></td></tr></tbody></table>

### Quick Start

Add the Cloud API Ruby SDK to your Gemfile:

```ruby
gem 'ionoscloud'
```

Then run:

```bash
bundle install
```

Or install directly:

```bash
gem install ionoscloud
```

Configure and initialise a client:

```ruby
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:

```ruby
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.

```bash
export IONOS_USERNAME=your@email.com
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](https://github.com/ionos-cloud) organisation on GitHub. They are published to RubyGems.org and follow the naming convention `ionoscloud-{service}` for product SDKs.