MikroTik Documentation
Installation Guide
Learn the difference between RouterOS, CHR, and Patch builds — where each one should be used,
which virtual machines or servers are best for each version, and how to activate extra Patch features.
RouterOS
Physical / Bare Metal
Some virtual use cases
Standard RouterOS package for x86, ARM, ARM64, MIPSBE, MMIPS, PPC, SMIPS, and TILE architectures.
Best for physical installations, dedicated network appliances, labs, and Netinstall-based setup.
CHR
Virtual Machines
CHR is the virtual RouterOS edition designed for virtualization and cloud-style deployments.
Best for VMware, Hyper-V, KVM/QEMU, VirtualBox, Proxmox, cloud labs, and virtual routing servers.
Patch
Advanced Users
Special-purpose builds that may include extra features such as shell access, custom licensing, or python3 packages.
Best for users who already know why they need a patch build. Not recommended as the default first choice.
Which one should I choose?
| Type |
Best For |
Recommended Platforms |
Notes |
| RouterOS |
Physical routers, bare metal servers, direct disk install |
Dedicated x86 hardware, supported compatible hardware |
Can be installed using Netinstall or disk-based methods. |
| CHR |
Virtual routing, VPS-like labs, hypervisors |
VMware, Hyper-V, VirtualBox, KVM/QEMU, Proxmox |
Recommended choice for virtual machines. |
| Patch |
Custom or special patched deployments |
Depends on patch target (RouterOS or CHR) |
Use only if you specifically need the patched image/package. |
Virtualization compatibility
| Platform |
Best Choice |
Recommended Format |
Comment |
| VMware ESXi / Workstation |
CHR |
VMDK |
One of the best choices for production-style virtual routing. |
| Hyper-V |
CHR |
VHDX |
Good option on Windows Server environments. |
| KVM / QEMU / Proxmox |
CHR |
RAW / QCOW2 |
Excellent for Linux virtualization and lab setups. |
| VirtualBox |
CHR |
VDI |
Best for learning, testing, and local labs. |
| Bare metal x86 server |
RouterOS |
ISO / IMG / NPK + Netinstall |
Good when you want direct hardware access. |
CHR is the preferred option for hypervisors. RouterOS is usually the better choice for direct hardware installation.
How to install RouterOS
- Choose the correct architecture package or image.
- For x86, use ISO or IMG for direct disk installation.
- For clean reinstall or recovery, use Netinstall.
- Upload extra packages if needed: wireless, routing, hotspot, user-manager, advanced-tools.
- Reboot and configure via Winbox, WebFig, or terminal.
How to install CHR
- Pick the correct CHR disk image for your hypervisor: VMDK, VHDX, VDI, RAW, QCOW2, or OVA.
- Create a new virtual machine.
- Attach the downloaded disk image instead of a normal OS installer.
- Allocate enough RAM, CPU, and network adapters.
- Boot the VM and configure RouterOS.
How to install Patch builds
- Select whether the patch is for RouterOS or CHR.
- Choose the matching architecture and version.
- Install the patched package or image like the normal base type.
- Follow Patch post-install steps below for shell, licensing, or python3.
Patch installation and activation
How to use shell
Shell access requires the extra option package.
- Install the
option-{version}.npk package.
- Open RouterOS terminal and run:
/system/telnet 127.0.0.1
- Login using:
User : devel
Pass : same as admin password
- After login, you can use the shell environment.
How to license RouterOS
Use the internal telnet shell to generate the license key manually.
- Open RouterOS terminal and run:
/system/telnet 127.0.0.1
- Login with username
devel.
- Use the same password as the admin account.
- Run:
keygen
- Copy the generated license key.
- Open the License section in RouterOS.
- Paste or import the generated key.
- Reboot the router once.
Online package updates are supported and can be performed without any issues.
Version guidance
RouterOS v6 legacy
Good for older deployments, legacy environments, and setups that depend on classic v6 package layout.
Better for older devices and existing deployments where package compatibility matters.
RouterOS v7 recommended
Better for new deployments, newer features, improved platform support, and modern packages.
Recommended for new installations unless you specifically need a legacy v6 environment.
Feature note
Some modern features are specific to newer builds or patch builds.
Choose v7 for new projects, and use patch builds only when you intentionally need their extra capabilities.
مستندات میکروتیک
راهنمای نصب میکروتیک
تفاوت RouterOS و CHR و Patch را ببینید، روش نصب هرکدام را یاد بگیرید،
بدانید هر نسخه برای چه ماشین مجازی یا چه سروری مناسبتر است، و مراحل فعالسازی قابلیتهای Patch را انجام دهید.
RouterOS
نصب روی سختافزار
بعضی سناریوهای مجازی
نسخه استاندارد RouterOS برای معماریهایی مثل x86، ARM، ARM64، MIPSBE، MMIPS، PPC، SMIPS و TILE.
مناسب برای نصب مستقیم روی سرور، سختافزار فیزیکی، و سناریوهای Netinstall یا نصب روی دیسک.
CHR
ماشین مجازی
CHR نسخه مجازی RouterOS است که برای محیطهای مجازیسازی و سناریوهای ابری طراحی شده است.
مناسب برای VMware، Hyper-V، KVM/QEMU، VirtualBox، Proxmox، روتر مجازی.
Patch
برای کاربران حرفهای
بیلدهای Patch نسخههای خاص هستند و ممکن است امکانات اضافه مثل shell، لایسنس سفارشی یا python3 داشته باشند.
برای استفاده عمومی و نصب اولیه معمولاً انتخاب اول نیستند.
کدام گزینه را انتخاب کنم؟
| نوع |
مناسب برای |
پلتفرم پیشنهادی |
توضیح |
| RouterOS |
روتر فیزیکی، سرور Bare Metal، نصب مستقیم |
سختافزار x86، سرورهای سازگار |
با Netinstall یا روش نصب روی دیسک قابل نصب است. |
| CHR |
روتر مجازی، هایپروایزر |
VMware، Hyper-V، VirtualBox، KVM/QEMU، Proxmox |
بهترین انتخاب برای نصب در ماشین مجازی است. |
| Patch |
سناریوهای خاص و نسخههای پچشده |
بسته به RouterOS یا CHR بودن Patch |
فقط وقتی استفاده شود که دقیقاً به همان Patch نیاز دارید. |
سازگاری با ماشینهای مجازی
| پلتفرم |
انتخاب بهتر |
فرمت پیشنهادی |
توضیح |
| VMware ESXi / Workstation |
CHR |
VMDK |
یکی از بهترین انتخابها برای روتر مجازی در محیط عملیاتی. |
| Hyper-V |
CHR |
VHDX |
برای محیطهای ویندوز سرور گزینه خوبی است. |
| KVM / QEMU / Proxmox |
CHR |
RAW / QCOW2 |
برای مجازیسازی لینوکسی مناسب است. |
| VirtualBox |
CHR |
VDI |
برای آموزش، تست و استفاده محلی بسیار مناسب است. |
| سرور x86 فیزیکی |
RouterOS |
ISO / IMG / NPK + Netinstall |
وقتی نصب مستقیم روی سختافزار میخواهی مناسبتر است. |
CHR برای هایپروایزرها انتخاب مناسبتری است. RouterOS معمولاً برای نصب مستقیم روی سختافزار بهتر است.
روش نصب RouterOS
- معماری درست را انتخاب کن.
- برای x86 اگر نصب مستقیم میخواهی، از ISO یا IMG استفاده کن.
- برای نصب تمیز یا بازیابی، از Netinstall استفاده کن.
- اگر به قابلیتهای اضافی نیاز داری، پکیجهای مربوطه را اضافه کن.
- سیستم را ریبوت کن و تنظیمات را با Winbox، WebFig یا ترمینال انجام بده.
روش نصب CHR
- فایل ایمیج مناسب هایپروایزر خودت را انتخاب کن: VMDK، VHDX، VDI، RAW، QCOW2 یا OVA.
- یک ماشین مجازی جدید بساز.
- بهجای نصب عادی سیستمعامل، دیسک ایمیج CHR را به VM وصل کن.
- RAM، CPU و کارت شبکه مناسب اختصاص بده.
- ماشین را روشن کن و RouterOS را تنظیم کن.
روش نصب Patch
- مشخص کن Patch مربوط به RouterOS است یا CHR.
- معماری و نسخه درست را انتخاب کن.
- Patch را مشابه نسخه پایه همان نوع نصب کن.
- برای shell، لایسنس یا python3، مراحل تکمیلی بخش Patch را انجام بده.
نصب و فعالسازی Patch
نحوه استفاده از shell
برای دسترسی به shell باید پکیج option نصب شود.
- پکیج
option-{version}.npk را نصب کنید.
- در ترمینال RouterOS این دستور را بزنید:
/system/telnet 127.0.0.1
- با این مشخصات وارد شوید:
User : devel
Pass : پسورد ادمین
- بعد از ورود، به محیط shell دسترسی دارید.
نحوه لایسنس کردن RouterOS
برای ساخت لایسنس از telnet داخلی و دستور keygen استفاده کنید.
- در ترمینال RouterOS این دستور را بزنید:
/system/telnet 127.0.0.1
- با نام کاربری
devel وارد شوید.
- پسورد همان پسورد اکانت ادمین روتر است.
- این دستور را اجرا کنید:
keygen
- لایسنس تولیدشده را کپی کنید.
- وارد بخش License شوید.
- لایسنس را Paste یا Import کنید.
- یکبار روتر را ریبوت کنید.
پکیجها را میتوان بهصورت آنلاین آپدیت کرد و این کار بدون ایجاد مشکل انجام میشود.
راهنمای انتخاب نسخه
RouterOS v6 legacy
مناسب برای محیطهای قدیمیتر، نصبهای legacy و جاهایی که ساختار پکیج v6 اهمیت دارد.
برای بعضی دستگاهها و سناریوهای قدیمی هنوز انتخاب مناسبی است.
RouterOS v7 recommended
برای نصبهای جدید، قابلیتهای جدیدتر و توسعههای جدید مناسبتر است.
اگر وابستگی خاصی به v6 نداری، برای پروژه جدید معمولاً v7 انتخاب بهتری است.
نکته مهم
بعضی قابلیتهای جدید فقط در بیلدهای جدیدتر یا Patch وجود دارند.
برای پروژه جدید معمولاً v7 مناسبتر است و Patch فقط زمانی پیشنهاد میشود که دقیقاً به امکانات اضافه آن نیاز داشته باشی.