---
title: hcloud_server
type: docs
---

[![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.hcloud_server) [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.hcloud_server?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.hcloud_server) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](LICENSE) 

Manage Hetzner Cloud server instances

* [Default Variables](#default-variables)
  * [hcloud_server](#hcloud-server)
  * [hcloud_server_default_api_token](#hcloud-server-default-api-token)
  * [hcloud_server_default_image](#hcloud-server-default-image)
  * [hcloud_server_rdns](#hcloud-server-rdns)
  * [hcloud_server_volumes](#hcloud-server-volumes)
* [Dependencies](#dependencies)

---

## Default Variables

### hcloud_server

#### Default value

```YAML
hcloud_server: {}
```

#### Example usage

```YAML
hcloud_server:
  name: my-server
  type: cx11
  ssh_keys: []
  image:
  location: "{{ hcloud_server_location }}"
  datacenter: "{{ hcloud_server_datacenter }}"
  api_token: "{{ hcloud_server_api_token | default(omit) }}"
```

### hcloud_server_default_api_token

#### Default value

```YAML
hcloud_server_default_api_token: _unset_
```

### hcloud_server_default_image

#### Default value

```YAML
hcloud_server_default_image: centos-7
```

### hcloud_server_rdns

#### Default value

```YAML
hcloud_server_rdns: []
```

#### Example usage

```YAML
hcloud_server_rdns:
  - addr: 1.2.3.4
    ptr: example.com
    state: present
```

### hcloud_server_volumes

#### Default value

```YAML
hcloud_server_volumes: []
```

#### Example usage

```YAML
hcloud_server_volumes:
  - name: my-volume
    size: 10
    state: present
```

## Dependencies

None.