Skip to content

Configuration

ZILLEALI edited this page May 20, 2026 · 1 revision

Configuration

Full reference for config/mikrotik.php.


Publish Config

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

Full Configuration

// config/mikrotik.php

return [

    // ─── Default Router ───────────────────────────────────────
    'host'     => env('MIKROTIK_HOST', '192.168.88.1'),
    'port'     => env('MIKROTIK_PORT', 8728),
    'username' => env('MIKROTIK_USERNAME', 'admin'),
    'password' => env('MIKROTIK_PASSWORD', ''),
    'timeout'  => env('MIKROTIK_TIMEOUT', 10),

    // ─── SSL ──────────────────────────────────────────────────
    'ssl'          => env('MIKROTIK_SSL', false),
    'verify_peer'  => env('MIKROTIK_SSL_VERIFY', false),
    'ca_cert_path' => env('MIKROTIK_SSL_CA_CERT', null),

    // ─── Retry ────────────────────────────────────────────────
    'retry_attempts' => env('MIKROTIK_RETRY_ATTEMPTS', 1),
    'retry_delay'    => env('MIKROTIK_RETRY_DELAY', 1000), // milliseconds

    // ─── Multi-Router ─────────────────────────────────────────
    'routers' => [
        // 'main' => [
        //     'host'     => '192.168.1.1',
        //     'port'     => 8728,
        //     'username' => 'admin',
        //     'password' => 'secret',
        //     'timeout'  => 10,
        //     'ssl'      => false,
        // ],
    ],

];

Environment Variables

Variable Default Description
MIKROTIK_HOST 192.168.88.1 Router IP address
MIKROTIK_PORT 8728 API port (8728 plain, 8729 SSL)
MIKROTIK_USERNAME admin RouterOS username
MIKROTIK_PASSWORD `` RouterOS password
MIKROTIK_TIMEOUT 10 Connection timeout in seconds
MIKROTIK_SSL false Enable SSL connection
MIKROTIK_SSL_VERIFY false Verify SSL certificate
MIKROTIK_SSL_CA_CERT null CA certificate path
MIKROTIK_RETRY_ATTEMPTS 1 Max connection attempts
MIKROTIK_RETRY_DELAY 1000 Delay between retries (ms)

Examples

Basic Setup

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

SSL Setup

MIKROTIK_HOST=192.168.88.1
MIKROTIK_PORT=8729
MIKROTIK_SSL=true
MIKROTIK_SSL_VERIFY=false
MIKROTIK_USERNAME=admin
MIKROTIK_PASSWORD=your-password

With Retry

MIKROTIK_RETRY_ATTEMPTS=3
MIKROTIK_RETRY_DELAY=2000

Multi-Router

// config/mikrotik.php
'routers' => [
    'main' => [
        'host'     => '192.168.1.1',
        'username' => 'admin',
        'password' => 'secret',
    ],
    'branch' => [
        'host'     => '192.168.2.1',
        'username' => 'admin',
        'password' => 'secret',
        'ssl'      => true,
        'port'     => 8729,
    ],
    'edge' => [
        'host'     => '10.0.0.1',
        'username' => 'monitor',
        'password' => 'readonly',
        'timeout'  => 5,
    ],
],
// Usage
MikroTik::router('main')->pppoe()->getActiveSessions();
MikroTik::router('branch')->system()->getCpuLoad();
MikroTik::router('edge')->interfaces()->getRunningInterfaces();

Managers Reference | Events →


📝 Found an error or missing info?
Edit this page or open an issue to suggest improvements.

Clone this wiki locally