Skip to content

How to adopt a Device

Having a adopted MikroTik is a crucial part of MKController’s experience. All of our features require an adopted device to work. In this manual, you’re gonna learn how to adopt an device on different scenarios and get started on your MKController journey.

Requirements

Before starting please make sure all of the requirements below are met:

  • You or a partner must have access to the Mikrotik you want adopt.

  • The Mikrotik you want to adopt must have connection to the internet.

    Does my Mikrotik has internet connection?Test connectivity using the ping feature (in this example, the test was performed with “ping 8.8.8.8”).

    IMAGE

  • DNS Name Resolution.

    Can my Mikrotik resolve domain names through DNS?Use the ping command (in this example, the test was performed with “ping google.com”) to verify if the device can resolve names.

    IMAGE

  • The Mikrotik you want to adopt must be under are supported OS versions.

  • Have an active MKController account.

How does it work and why it’s safe

The process of adopting Mikrotik on the MKController platform is an essential procedure that establishes a secure connection between your equipment and the centralized management system. This integration is performed through an encrypted VPN connection between the MKController servers and the Mikrotik device, ensuring a secure and reliable communication channel.

This security architecture allows remote control, continuous monitoring and application of automated configurations, even when the devices are on different networks or behind firewalls. Although the process is technically simple, each step must be executed correctly to ensure a stable and functional connection.

Adopting a Mikrotik

1. On a logged in account, click on the “Add device” button to start the adoption process.

Adopt Mikrotik device in MKController.

2. Choose a desired device name. This is a simple display name and be changed anytime you desire.

Adopt Mikrotik device in MKController.

3. Now you can select how you want to adopt your Mikrotik by choosing a adoption helper option. This is not a permanent choice, you can always go back and try another way if you like.

Adopt Mikrotik device in MKController.

You can follow the adoption helper on the platform to guide you through the proccess or stay on this tutorial and select one of the options below:

Link via Webfig - We will guide you on how to link your device using Webfig.

1. On your browser, access your device using its IP address.

  • When connected via cable, it is usually 192.168.88.1.

Adopt Mikrotik device in MKController.

2. Accessing the scripts menu.

  • After logging into your device, look for the System option in the side menu. Click on it and then go to Scripts.

Adopt Mikrotik device in MKController.

3. Creating a new webfig script.

  • Once inside the Script function, click the “Add New” button to create a new script.
  • Copy the script provided by MKController and paste it into the ‘source’ field. Then, click Apply.
  • You can generate a MKController Adoption Script by selecting the “Link via Script” option on the Adoption Helper or follow the “Link via Webfig” steps option on the Adoption Helper.

Adopt Mikrotik device in MKController.

4. Executing the script.

  • Run the webfig script created in the previous step and wait until the process is complete.

Adopt Mikrotik device in MKController.

5. How to know if the script worked properly?

  • All of the adoption helper final steps contain this following message:

Adopt Mikrotik device in MKController.

  • When your Mikrotik establishes connection to our server, the message showed above will change to a progress section, wich will visually inform you step by step about the adoption progress:

Adopt Mikrotik device in MKController. (After your Mikrotik establishes connection to our server, the user need’s to wait untill the process showed above be completed)

Link via Winbox - We will guide you on how to link your device using Winbox.1\. Accessing the device. - Open Winbox and connect to your device.

Adopt Mikrotik device in MKController.

2. Accessing the scripts menu.

  • After logging into your device, look for the System option in the side menu. Click on it and then go to Scripts.

Adopt Mikrotik device in MKController.

3. Creating a new webfig script.

  • Once inside the Script function, click the “Add New” button to create a new script.
  • Copy the script provided by MKController and paste it into the ‘source’ field. Then, click Apply.
  • You can generate a MKController Adoption Script by selecting the “Link via Script” option on the Adoption Helper or follow the “Link via Winbox” steps option on the Adoption Helper.

Adopt Mikrotik device in MKController.

4. Executing the script.

  • Run the webfig script created in the previous step and wait until the process is complete.

Adopt Mikrotik device in MKController.

5. How to know if the script worked properly?

  • All of the adoption helper final steps contain this following message:

Adopt Mikrotik device in MKController.

  • When your Mikrotik establishes connection to our server, the message showed above will change to a progress section, wich will visually inform you step by step about the adoption progress:

Adopt Mikrotik device in MKController. (After your Mikrotik establishes connection to our server, the user need’s to wait untill the process showed above be completed)

Link via SSH - We will guide you on how to link your device using the terminal.

1. Accessing the device

  • Open the terminal on your computer/operating system and connect via SSH.
  • The default access is usually admin@(yourIP).
  • If the device has a password, it will also be required.

Adopt Mikrotik device in MKController.

2. Executing the script.

  • Copy the script provided by MKController and run it on the terminal. Then wait until the process is complete.
  • You can generate a MKController Adoption Script by selecting the “Link via Script” option on the Adoption Helper or follow the “Link via SSH” steps option on the Adoption Helper.

Adopt Mikrotik device in MKController.

3. How to know if the script worked properly?

  • All of the adoption helper final steps contain this following message:

Adopt Mikrotik device in MKController.

  • When your Mikrotik establishes connection to our server, the message showed above will change to a progress section, wich will visually inform you step by step about the adoption progress:

Adopt Mikrotik device in MKController. (After your Mikrotik establishes connection to our server, the user need’s to wait untill the process showed above be completed)

Next Steps

Congratitulations! Now that you’ve adopted your first Mikrotik we can show you one of MKController’s core features: Remote Access.

  • There are 3 ways you can start a remote access on our platform. They all start on the devices tab: Adopt Mikrotik device in MKController.
Access through table mode.

Adopt Mikrotik device in MKController.

Access through card mode.

Adopt Mikrotik device in MKController.

Access through device details.

Adopt Mikrotik device in MKController.

Removing a Mikrotik

Efficient network device management is fundamental to maintaining organization and control over the IT environment. Occasionally, the need arises to remove MikroTik devices from the management system, whether due to equipment replacement, infrastructure reorganization, or simply to clean up obsolete records.

The “Forget device” functionality allows administrators to permanently remove MikroTik device representations from the system, ensuring that only active and relevant equipment remains in the inventory. This process is irreversible and must be executed carefully, as all configurations and histories associated with the devices will be lost.


Removing MikroTik Devices in MKController

In the Devices menu, locate and select one or more representations of the MikroTik device you wish to remove. For this example, two device representations were selected.

With the devices selected, click the Action button to access the available options.

Selecting Mikrotik to remove from MKController.

In the dropdown menu that appears, select the “Forget device” option.

Forget Mikrotik device to remove from MKController.

The system will present a confirmation screen displaying the names of the MikroTik device representations that will be removed. Carefully verify that the listed devices are indeed the ones you wish to delete.

Then, select the “Forget” button.

A new confirmation screen will be displayed. To proceed with the definitive removal of the devices, click the “Confirm” button.

Confirm Mikrotik device to remove from MKController.

After the operation is processed, the system will display the message “The Operation was a success”. Select OK to finalize the process.