Skip to content

Ansible modules for managing Mikrotik RouterOS-based devices

License

Notifications You must be signed in to change notification settings

CFSworks/ansible-routeros

Repository files navigation

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.

About

Ansible modules for managing Mikrotik RouterOS-based devices

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published