https://github.com/terraform-hc-modules/terraform-hcloud-compute

Terraform module for Hetzner Cloud compute (Server, Volume, SSH Key, Placement Group, Snapshot)
https://github.com/terraform-hc-modules/terraform-hcloud-compute

compute hcloud hetzner server terraform terraform-module volume

Last synced: about 4 hours ago
JSON representation

Terraform module for Hetzner Cloud compute (Server, Volume, SSH Key, Placement Group, Snapshot)

Host: GitHub
URL: https://github.com/terraform-hc-modules/terraform-hcloud-compute
Owner: terraform-hc-modules
License: mpl-2.0
Created: 2026-04-20T12:14:21.000Z (3 months ago)
Default Branch: main
Last Pushed: 2026-05-10T06:06:03.000Z (about 2 months ago)
Last Synced: 2026-05-24T05:06:20.814Z (about 1 month ago)
Topics: compute, hcloud, hetzner, server, terraform, terraform-module, volume
Language: HCL
Size: 51.8 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

          # Hetzner Cloud Compute Module

[![Terraform](https://img.shields.io/badge/Terraform-%3E%3D1.0-blueviolet)](https://www.terraform.io/)

[![License: MPL-2.0](https://img.shields.io/badge/License-MPL--2.0-blue.svg)](https://opensource.org/licenses/MPL-2.0)

[![CI](https://github.com/terraform-hc-modules/terraform-hcloud-compute/actions/workflows/ci.yml/badge.svg)](https://github.com/terraform-hc-modules/terraform-hcloud-compute/actions/workflows/ci.yml)

[![Release](https://img.shields.io/github/v/release/terraform-hc-modules/terraform-hcloud-compute)](https://github.com/terraform-hc-modules/terraform-hcloud-compute/releases)

Terraform module for compute resources on Hetzner Cloud including Server, Volume, SSH Key, Placement Group, and Snapshot.

## Usage

### Complete Example

```hcl

module "compute" {

  source  = "terraform-hc-modules/compute/hcloud"

  version = "~> 0.1"

  name        = "my-server"

  server_type = "cx22"

  image       = "ubuntu-24.04"

  location    = "fsn1"

  create_ssh_key = true

  public_key     = file("~/.ssh/id_rsa.pub")

  create_volume   = true

  volume_size     = 50

  volume_format   = "ext4"

  volume_automount = true

  create_placement_group = true

  labels = {

    Environment = "production"

  }

}

```

### Using Submodules Individually

```hcl

# Server only

module "server" {

  source  = "terraform-hc-modules/compute/hcloud//modules/server"

  version = "~> 0.1"

  name        = "my-server"

  server_type = "cx22"

  image       = "ubuntu-24.04"

}

# SSH Key only

module "ssh_key" {

  source  = "terraform-hc-modules/compute/hcloud//modules/ssh-key"

  version = "~> 0.1"

  name       = "my-key"

  public_key = file("~/.ssh/id_rsa.pub")

}

# Volume only

module "volume" {

  source  = "terraform-hc-modules/compute/hcloud//modules/volume"

  version = "~> 0.1"

  name     = "my-volume"

  size     = 50

  location = "fsn1"

}

```

## Submodules

| Module | Description |

|--------|-------------|

| [server](modules/server) | Server with network attachments and rDNS |

| [volume](modules/volume) | Block storage volumes |

| [ssh-key](modules/ssh-key) | SSH keys |

| [placement-group](modules/placement-group) | Anti-affinity groups |

| [snapshot](modules/snapshot) | Server snapshots |

## Examples

- [Simple](examples/simple) - Server only

- [Complete](examples/complete) - Server + Volume + SSH Key + Placement Group

- [Snapshot](examples/snapshot) - Server with snapshot

## Requirements

| Name | Version |

| ---- | ------- |

|  [terraform](#requirement\_terraform) | >= 1.0 |

|  [hcloud](#requirement\_hcloud) | >= 1.45 |

## Providers

No providers.

## Modules

| Name | Source | Version |

| ---- | ------ | ------- |

|  [placement\_group](#module\_placement\_group) | ./modules/placement-group | n/a |

|  [server](#module\_server) | ./modules/server | n/a |

|  [ssh\_key](#module\_ssh\_key) | ./modules/ssh-key | n/a |

|  [volume](#module\_volume) | ./modules/volume | n/a |

## Resources

No resources.

## Inputs

| Name | Description | Type | Default | Required |

| ---- | ----------- | ---- | ------- | :------: |

|  [name](#input\_name) | Name of the server. | `string` | n/a | yes |

|  [backups](#input\_backups) | Enable backups. | `bool` | `false` | no |

|  [create\_placement\_group](#input\_create\_placement\_group) | Whether to create a placement group. | `bool` | `false` | no |

|  [create\_server](#input\_create\_server) | Whether to create the server. | `bool` | `true` | no |

|  [create\_ssh\_key](#input\_create\_ssh\_key) | Whether to create an SSH key. | `bool` | `false` | no |

|  [create\_volume](#input\_create\_volume) | Whether to create a volume. | `bool` | `false` | no |

|  [firewall\_ids](#input\_firewall\_ids) | Firewall IDs to attach. | `list(number)` | `[]` | no |

|  [image](#input\_image) | Image to use. | `string` | `"ubuntu-24.04"` | no |

|  [labels](#input\_labels) | Labels to apply. | `map(string)` | `{}` | no |

|  [location](#input\_location) | Location. | `string` | `"fsn1"` | no |

|  [networks](#input\_networks) | Networks to attach. | 
list(object({
    network_id = number
    ip         = optional(string)
    alias_ips  = optional(list(string), [])
  })) | `[]` | no |

|  [placement\_group\_name](#input\_placement\_group\_name) | Name of the placement group. | `string` | `null` | no |

|  [placement\_group\_type](#input\_placement\_group\_type) | Type of the placement group. | `string` | `"spread"` | no |

|  [public\_key](#input\_public\_key) | Public key content. | `string` | `""` | no |

|  [server\_type](#input\_server\_type) | Server type. | `string` | `"cx22"` | no |

|  [ssh\_key\_name](#input\_ssh\_key\_name) | Name of the SSH key. | `string` | `null` | no |

|  [ssh\_keys](#input\_ssh\_keys) | SSH key IDs or names. | `list(string)` | `[]` | no |

|  [user\_data](#input\_user\_data) | Cloud-init user data. | `string` | `null` | no |

|  [volume\_automount](#input\_volume\_automount) | Automount the volume. | `bool` | `false` | no |

|  [volume\_format](#input\_volume\_format) | Format of the volume. | `string` | `null` | no |

|  [volume\_name](#input\_volume\_name) | Name of the volume. | `string` | `null` | no |

|  [volume\_size](#input\_volume\_size) | Size of the volume in GB. | `number` | `10` | no |

## Outputs

| Name | Description |

| ---- | ----------- |

|  [ipv4\_address](#output\_ipv4\_address) | IPv4 address of the server. |

|  [ipv6\_address](#output\_ipv6\_address) | IPv6 address of the server. |

|  [placement\_group](#output\_placement\_group) | Placement group attributes. |

|  [placement\_group\_id](#output\_placement\_group\_id) | ID of the placement group. |

|  [server](#output\_server) | Server attributes. |

|  [server\_id](#output\_server\_id) | ID of the server. |

|  [server\_name](#output\_server\_name) | Name of the server. |

|  [server\_network\_attachments](#output\_server\_network\_attachments) | Map of server network attachments keyed by index. |

|  [server\_rdns](#output\_server\_rdns) | Map of server reverse DNS entries keyed by index. |

|  [ssh\_key](#output\_ssh\_key) | SSH key attributes. |

|  [ssh\_key\_fingerprint](#output\_ssh\_key\_fingerprint) | Fingerprint of the SSH key. |

|  [ssh\_key\_id](#output\_ssh\_key\_id) | ID of the SSH key. |

|  [volume](#output\_volume) | Volume attributes. |

|  [volume\_id](#output\_volume\_id) | ID of the volume. |

|  [volume\_linux\_device](#output\_volume\_linux\_device) | Linux device path of the volume. |

## License

Mozilla Public License 2.0 - see [LICENSE](LICENSE)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/terraform-hc-modules/terraform-hcloud-compute

Awesome Lists containing this project

README