Skip to content

Latest commit

 

History

History
36 lines (27 loc) · 1.21 KB

README.md

File metadata and controls

36 lines (27 loc) · 1.21 KB
Raw

Ansible Modules for Mikrotik RouterOS

Overview

This repository includes the following Ansible modules:

  • routeros_facts: Return ansible_facts for the device
  • routeros_copy: Copy files from the local machine to the device
  • routeros_fetch: Copy files from the device to the local machine
  • routeros_command: Run a RouterOS command against the API directly
  • routeros_item: Create/update/delete configuration items in the API hierarchy

Requirements

  • Latest Ansible
  • Latest librouteros
  • Mikrotik RouterOS-based device (e.g. RouterBOARD or Mikrotik CHR)
  • API server enabled (check for port 8728 open)

Acknowledgements

I previously started by trying to update zahodi and senorsmile's ansible-mikrotik repository.

While trying to reorganize it, I decided it was ultimately better to start with a collection of modules based more fundamentally on RouterOS's print/set/add command set, and focus on flexibility rather than having a module for each feature.

License

Code here is released under GPLv3 for maximum compatibility with Ansible Core.