octodns-routeros

RouterOS DHCP lease source for octoDNS.

Fetches active (bound) DHCP leases from a MikroTik RouterOS device via the REST API and provides them as DNS A/AAAA records.

Router-side prerequisites

Enable the HTTPS API service on the router:

/ip service enable www-ssl

Or for plain HTTP (not recommended):

/ip service enable www

Installation

pip install octodns-routeros

Configuration

providers:
  routeros:
    class: octodns_routeros.RouterOSSource
    # Required: router hostname/IP
    host: 192.0.2.1
    # Required: API user
    user: admin
    # Password: literal value, or env/<var> to pull from environment
    password: env/ROS_PASS

    # Optional settings (shown with defaults)
    scheme: https
    verify: false
    port: null           # null = default port (443/80)
    timeout: 10
    ttl: 300            # TTL for generated records

zones:
  dyn.example.com.:
    sources:
      - routeros
    targets:
      - your_dns_provider

Alternatively, the password can be specified directly:

    password: your_secret_password

Or via a ROS_PASS environment variable in the shell running octoDNS.

How it works

On each sync cycle, the source:

1. Queries the RouterOS REST API for bound DHCP leases from both /rest/ip/dhcp-server/lease (IPv4) and /rest/ipv6/dhcp-server/lease (IPv6).
2. Each bound lease with a non-empty host-name creates a record:
   • Only the first label of the host name is used as the record name (e.g. laptop.lan becomes laptop).
   • IPv4 addresses produce A records.
   • IPv6 addresses produce AAAA records.
3. A missing IPv6 endpoint (HTTP 404) is silently ignored — safe for RouterOS 6.x or routers without IPv6 DHCP.

Development

# Install dependencies
uv sync --group dev

# Run tests
uv run pytest

Releasing

1. Update CHANGELOG.md — move the new version's entry from - unreleased to a date and add any missing items.
2. Commit and push to main.
3. Tag the release: git tag 0.2.0 && git push --tags.

CI will run the test suite, build the package, create a GitLab Release with the changelog section, and publish to PyPI.

Changes

See CHANGELOG.md for release history.

License

MIT