# Java SDKs

Use the IONOS Cloud Java SDKs to build Java apps on IONOS Cloud. Each SDK is available on Maven Central.

### Available Java 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 Java SDK</strong></mark></td><td>Manage compute, networking, and storage</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/-MUOjRYzZDMOe8N1Sjb9-3956399747/">Java SDKs</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 Java SDK</strong></mark></td><td>Provision and manage MongoDB clusters</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/02d9zmQRDOSe16EmUhUB/">DBaaS Mongo Java SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>DBaaS Postgres Java SDK</strong></mark></td><td>Provision and manage PostgreSQL clusters</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/QrYa6RYxx5nsHC9p5p5W/">DBaaS Postgres Java SDK</a></td></tr><tr><td><mark style="color:blue;"><strong>MariaDB SDK Java</strong></mark></td><td>Provision and manage MariaDB clusters</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/r3TpTtLe2olfIPMz0I9S/">MariaDB SDK Java</a></td></tr></tbody></table>

#### Containers

<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 Java SDK</strong></mark></td><td>Manage container registries and image repositories</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/27JzDsjGWjmmyROf27Up/">Container Registry Java 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 Java SDK</strong></mark></td><td>Manage TLS/SSL certificates</td><td><a href="https://app.gitbook.com/o/-MKo2eBjDjmABTFNKPGq/s/z09I0mjOZe9OaHE0rToX/">Certificate Manager Java SDK</a></td></tr></tbody></table>

### Quick Start

Add the SDK to your Maven project:

```xml
<dependency>
    <groupId>com.ionoscloud</groupId>
    <artifactId>ionos-cloud-sdk</artifactId>
    <version>LATEST</version>
</dependency>
```

Or with Gradle:

```groovy
implementation 'com.ionoscloud:ionos-cloud-sdk:LATEST'
```

Set up a client:

```java
import com.ionoscloud.ApiClient;
import com.ionoscloud.Configuration;

ApiClient client = Configuration.getDefaultApiClient();
client.setUsername(System.getenv("IONOS_USERNAME"));
client.setPassword(System.getenv("IONOS_PASSWORD"));
```

Use a token instead:

```java
HttpBearerAuth tokenAuth =
    (HttpBearerAuth) client.getAuthentication("Token Authentication");
tokenAuth.setBearerToken(System.getenv("IONOS_TOKEN"));
```

### Authentication

All Java 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

# Use a token for CI/CD:
export IONOS_TOKEN=your_api_token
```

### GitHub Repositories

All Java SDKs are open source on GitHub under [ionos-cloud](https://github.com/ionos-cloud). Product SDKs follow the pattern `ionos-cloud-sdk-{service}`.