---
title: network
type: docs
---

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

Manage linux network configuration.

* [Default Variables](#default-variables)
  * [network_defaultif](#network_defaultif)
  * [network_disable_ipv6](#network_disable_ipv6)
  * [network_dns_server](#network_dns_server)
  * [network_fqdn](#network_fqdn)
  * [network_hostname](#network_hostname)
  * [network_hosts_entries](#network_hosts_entries)
  * [network_interfaces](#network_interfaces)
  * [network_routes](#network_routes)
* [Dependencies](#dependencies)

---

## Default Variables

### network_defaultif

#### Default value

```YAML
network_defaultif: eth0
```

### network_disable_ipv6

#### Default value

```YAML
network_disable_ipv6: false
```

### network_dns_server

#### Default value

```YAML
network_dns_server: 8.8.8.8
```

### network_fqdn

#### Default value

```YAML
network_fqdn: localdomain
```

### network_hostname

#### Default value

```YAML
network_hostname: localhost
```

### network_hosts_entries

#### Default value

```YAML
network_hosts_entries: []
```

#### Example usage

```YAML
network_hosts_entries:
  - hostname: myhost
    fqdn: myhost.rknet.org
    address: 1.2.3.4
```

### network_interfaces

#### Default value

```YAML
network_interfaces: {}
```

#### Example usage

```YAML
network_interfaces:
  eth0:
    bootproto: none
    onboot: yes
    hwaddr: "aa:bb:cc:dd:ee"
    ipaddr: 192.168.0.5
    prefix: 26
    gateway: "192.168.0.1"
    userctl: no
```

### network_routes

#### Default value

```YAML
network_routes: {}
```

#### Example usage

```YAML
network_routes:
  eth0: |
    10.168.0.1/32 via 0.0.0.0 dev eth0 scope link
    10.168.0.0/27 via 10.168.0.1 dev eth0
```

## Dependencies

None.