> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MikroTik Switch

> Connect a MikroTik (RouterOS/SwOS) switch to Myrmex over SSH — create the CLI account and add the integration.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Connect your **MikroTik** switch (CRS/CSS running RouterOS) so Myrmex can read its configuration, audit its hardening, run diagnostics, and — with approval — apply CLI changes. Myrmex reaches the device over **SSH** through a [Collector](/documentation/agent-endpoint-security/collector-mode) on your network and queries it in real time.

## What Myrmex Can Do

<CardGroup cols={2}>
  <Card title="Read & troubleshoot" icon="magnifying-glass">
    Inspect interfaces, VLANs, bridge, IP addressing, and system state — read-only diagnostics on RouterOS.
  </Card>

  <Card title="Hardening audit" icon="shield-halved">
    Run a [Security Posture](/documentation/security-posture/overview) audit against the switch configuration.
  </Card>

  <Card title="Run CLI commands" icon="terminal">
    Execute operational and configuration commands, with changes applied on approval.
  </Card>

  <Card title="Config & inventory" icon="floppy-disk">
    Review the running configuration and track the model and RouterOS version — read on demand, never stored.
  </Card>
</CardGroup>

## Before You Start

* A **Collector** that can reach the switch's management IP over SSH. See [Deploying the agent](/documentation/agent-endpoint-security/installation) and [Collector mode](/documentation/agent-endpoint-security/collector-mode).
* An **account with CLI access** to the device — read-only is enough for analysis; read-write is required to apply changes.

## Step 1 — Create the Credential in MikroTik

<Steps>
  <Step title="Enable SSH">
    In RouterOS, make sure the SSH service is enabled under **IP → Services** (`/ip service`), and note the port (default `22`). Restrict the service to your Collector's address where possible.
  </Step>

  <Step title="Create a user">
    Under **System → Users** (`/user`), add a user for Myrmex with a strong password. Assign the `full` group for read-write access, or the `read` group for analysis only. Note the username and password.
  </Step>
</Steps>

<Tip>
  Prefer least privilege: start with the `read` group, and grant `full` only when you want the agents to apply changes for you.
</Tip>

## Step 2 — Add the Integration in Myrmex

From the [Directory](/documentation/ai-workspace/overview#the-directory), choose **Add Integration → MikroTik Switch**, then fill in:

| Field           | Description                                                                                           |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Name**        | A unique name for this switch.                                                                        |
| **Description** | Optional note to identify the device.                                                                 |
| **IP**          | The MikroTik management interface IP or hostname the Collector can reach.                             |
| **SSH Port**    | The SSH port (default `22`).                                                                          |
| **Username**    | The CLI account created in Step 1.                                                                    |
| **Password**    | That account's password.                                                                              |
| **Model**       | Your MikroTik switch model series (CRS/CSS).                                                          |
| **Version**     | The RouterOS/SwOS version running on the device.                                                      |
| **Collector**   | The [Collector](/documentation/agent-endpoint-security/collector-mode) that opens the SSH connection. |

## Connect

Click **Connect** to validate the SSH connection and finish. The switch then appears under **Environment → Integrations**, and you can ask the [Integration Specialist](/documentation/multi-agent-system/integration-specialist-agent) about it in the Workspace.

<Note>
  Myrmex queries the switch in real time over SSH and acts only on approval. It does not store or retain the device's configuration or data on the Myrmex side.
</Note>