Getting Started

Getting Started

Requirements

Requirement	Version
PHP	^8.2
Laravel	^11.0 or ^12.0
RouterOS	v6.43+ or v7.x

Installation

composer require zilleali/mikrotik-laravel

Publish config:

php artisan vendor:publish --tag=mikrotik-config

Configuration

Add to .env:

MIKROTIK_HOST=192.168.88.1
MIKROTIK_PORT=8728
MIKROTIK_USERNAME=admin
MIKROTIK_PASSWORD=your-password
MIKROTIK_TIMEOUT=10

# SSL (optional)
MIKROTIK_SSL=false
MIKROTIK_SSL_VERIFY=false

Basic Usage

use ZillEAli\MikrotikLaravel\Facades\MikroTik;

// PPPoE sessions
$sessions = MikroTik::pppoe()->getActiveSessions();

// System health
$cpu    = MikroTik::system()->getCpuLoad();
$uptime = MikroTik::system()->getUptime();

// Hotspot users
$users = MikroTik::hotspot()->getUsers();

// Firewall
MikroTik::firewall()->addToAddressList('1.2.3.4', 'blocked');

Enable API on Router

WinBox → IP → Services → api → Enable Port: 8728 (plain) or 8729 (SSL)

Multi-Router Setup

// config/mikrotik.php
'routers' => [
    'main' => [
        'host'     => '192.168.1.1',
        'username' => 'admin',
        'password' => 'secret',
    ],
    'branch' => [
        'host'     => '192.168.2.1',
        'username' => 'admin',
        'password' => 'secret',
    ],
],

// Usage
MikroTik::router('branch')->pppoe()->getActiveSessions();