## [![DebOps project](http://debops.org/images/debops-small.png)](http://debops.org) subnetwork

<!-- This file was generated by Ansigenome. Do not edit this file directly but
     instead have a look at the files in the ./meta/ directory. -->

[![Travis CI](http://img.shields.io/travis/debops/ansible-subnetwork.svg?style=flat)](http://travis-ci.org/debops/ansible-subnetwork)
[![test-suite](http://img.shields.io/badge/test--suite-ansible--subnetwork-blue.svg?style=flat)](https://github.com/debops/test-suite/tree/master/ansible-subnetwork/)
[![Ansible Galaxy](http://img.shields.io/badge/galaxy-debops.subnetwork-660198.svg?style=flat)](https://galaxy.ansible.com/detail#/role/2128)


`debops.subnetwork` is an Ansible role that creates and manages a local
network behind a bridge interface. It could also manage internal router
interfaces to a LAN. You can specify an IPv4 subnet and one or more
IPv6 subnets to configure it, the role will automatically configure basic
forwarding in any firewall and NAT for the IPv4 network.

### Installation

This role requires at least Ansible `v2.0.0`. To install it, run:

```Shell
ansible-galaxy install debops.subnetwork
```

### Documentation

More information about `debops.subnetwork` can be found in the
[official debops.subnetwork documentation](http://docs.debops.org/en/latest/ansible/roles/ansible-subnetwork/docs/).



### Are you using this as a standalone role without DebOps?

You may need to include missing roles from the [DebOps common
playbook](https://github.com/debops/debops-playbooks/blob/master/playbooks/common.yml)
into your playbook.

[Try DebOps now](https://github.com/debops/debops) for a complete solution to run your Debian-based infrastructure.





### Authors and license

`subnetwork` role was written by:

- Maciej Delmanowski | [e-mail](mailto:drybjed@gmail.com) | [Twitter](https://twitter.com/drybjed) | [GitHub](https://github.com/drybjed)
- [Robin Schneider](http://ypid.de/) | [e-mail](mailto:ypid@riseup.net) | [Twitter](https://twitter.com/ypid) | [GitHub](https://github.com/ypid)

License: [GPLv3](https://tldrlegal.com/license/gnu-general-public-license-v3-%28gpl-3%29)

***

This role is part of the [DebOps](http://debops.org/) project. README generated by [ansigenome](https://github.com/nickjj/ansigenome/).
