sinuscosinustan/hetznercloud-java — 59 Stars

sinuscosinustan

hetznercloud-java

Java

Java Library for the Hetzner Cloud API - NOW ON CODEBERG

Last updated May 25, 2026

Stars

Forks

Issues

Stars/day

Attention Score

View on GitHub ↗ Open in github.dev

Topics

#automation #hcloud #hetzner #hetzner-cloud #java

Language breakdown

Java 100.0%

▸ Files click to expand

README

Hetzner Cloud API for Java ==========================

THE CODE NOW LIVES ON CODEBERG!

Simple Java client for the Hetzner Cloud API.

Important message about this project here

Compile

This project uses Maven as build automation.

Just run `mvn clean install to install it in the local Maven repository cache.


How to use
Maven
Dependency:
<pre><code class="lang-xml">&lt;dependencies&gt;     &lt;dependency&gt;         &lt;groupId&gt;io.github.sinuscosinustan&lt;/groupId&gt;         &lt;artifactId&gt;hetznercloud-api&lt;/artifactId&gt;         &lt;version&gt;5.0.2&lt;/version&gt;     &lt;/dependency&gt; &lt;/dependencies&gt;</code></pre>
Gradle

Put this in the build.gradle file of the project:


<pre><code class="lang-groovy">repositories {     mavenCentral() }
dependencies {     implementation &quot;io.github.sinuscosinustan:hetznercloud-api:5.0.2&quot; }</code></pre>
<details>   <summary>kotlin-dsl</summary>
<pre><code class="lang-kotlin">dependencies {     implementation(&quot;io.github.sinuscosinustan:hetznercloud-api:5.0.2&quot;) }</code></pre> </details>
Requirements
Java 17 or higher
Maven 3.6.0 or higher

How to run tests
This project has unit tests, as well as integration tests.
Unit Tests (Default)
<pre><code class="lang-bash">mvn test</code></pre>
Integration Tests
Integration tests require an API Token for the Hetzner Cloud. Set the API token as an environment variable called

HCLOUD_TOKEN

.
To obtain an API key, please see the official API documentation.
<pre><code class="lang-bash">HCLOUDTOKEN=&quot;${apikey}&quot; mvn test -Pintegration-tests</code></pre>
Code Quality
Checkstyle
Checkstyle runs automatically during compilation:
<pre><code class="lang-bash">mvn compile</code></pre>
Code Coverage (JaCoCo)
Generate code coverage reports:
<pre><code class="lang-bash">mvn test</code></pre>
View the HTML report at

target/site/jacoco/index.html`