License Management
License Management
Section titled âLicense ManagementâTL;DR (Quick Start)
Section titled âTL;DR (Quick Start)âFor the impatient: check your license status.
/system/license/printRouterBOARD devices: Pre-licensed, no action needed.
CHR (Cloud Hosted Router): Activate a paid license after purchase:
/system/license/renewOverview
Section titled âOverviewâWhat this does: RouterOS licensing controls feature availability and, for CHR, throughput limits. RouterBOARD hardware comes pre-licensed. x86 and CHR installations require license management.
When to use this:
- Checking your current license level and features
- Activating a purchased CHR license
- Upgrading from trial to paid license
- Troubleshooting license renewal issues
Prerequisites:
- MikroTik account at mikrotik.com (for CHR and x86 purchases)
- Internet connectivity to
licence.mikrotik.com(for CHR renewal)
License Types
Section titled âLicense TypesâRouterBOARD Hardware
Section titled âRouterBOARD HardwareâAll RouterBOARD devices ship with a permanent license pre-installed:
| License Level | Included With | Key Features |
|---|---|---|
| Level 4 (WISP) | Home/SOHO routers | 200 PPP tunnels, 200 HotSpot users |
| Level 5 (WISP) | Professional devices | 500 PPP tunnels, 500 HotSpot users |
| Level 6 (Controller) | Enterprise/CCR | Unlimited tunnels and users |
No action required - the license is bound to the deviceâs storage.
Cloud Hosted Router (CHR)
Section titled âCloud Hosted Router (CHR)âCHR uses a different licensing model based on throughput:
| License | Speed Limit | Price | Notes |
|---|---|---|---|
| Free | 1 Mbps upload/interface | $0 | Unlimited duration |
| P1 | 1 Gbps upload/interface | $45 | Perpetual |
| P10 | 10 Gbps upload/interface | $95 | Perpetual |
| P-Unlimited | No limit | $250 | Perpetual |
All paid licenses are perpetual (buy once, use forever).
x86 RouterOS
Section titled âx86 RouterOSâStandard RouterOS on x86 hardware uses traditional license levels:
| Level | Price | PPP Tunnels | HotSpot Users | Wireless AP |
|---|---|---|---|---|
| 0 (Trial) | Free | Limited | Limited | 24 hours |
| 1 (Demo) | Free | 1 each | 1 | No |
| 3 (CPE) | N/A | 200 each | 1 | Station only |
| 4 (WISP) | $45 | 200 each | 200 | Yes |
| 5 (WISP) | $95 | 500 each | 500 | Yes |
| 6 (Controller) | $250 | Unlimited | Unlimited | Yes |
Configuration Steps
Section titled âConfiguration StepsâStep 1: Check Current License
Section titled âStep 1: Check Current LicenseâView your license status:
/system/license/printRouterBOARD output:
software-id: XXXX-XXXX level: 6 features:CHR output:
system-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx level: free features: next-renewal-at: jan/20/2026 12:00:00 deadline-at: feb/20/2026 12:00:00Step 2: Activate CHR License (After Purchase)
Section titled âStep 2: Activate CHR License (After Purchase)âAfter purchasing a CHR license on mikrotik.com:
- Assign the license to your CHR in the MikroTik client portal
- Renew from the router:
/system/license/renew
- Verify activation:
/system/license/print
Step 3: Request CHR Trial (Optional)
Section titled âStep 3: Request CHR Trial (Optional)âTest paid license levels for 60 days:
/system/license/renew level=p1Youâll be prompted for your MikroTik account credentials.
Common Scenarios
Section titled âCommon ScenariosâScenario: View License on RouterBOARD
Section titled âScenario: View License on RouterBOARDâ/system/license/printRouterBOARD licenses show level (4, 5, or 6) and software-id bound to the device.
Scenario: Generate New System ID (CHR)
Section titled âScenario: Generate New System ID (CHR)âFor cloud providers where VMs may share IDs (e.g., Linode), generate a unique ID before requesting a trial:
/system/license/generate-new-idOnly use this command on CHR instances running the free license tier. Using it on paid licenses may cause issues.
Scenario: Check CHR Renewal Status
Section titled âScenario: Check CHR Renewal Statusâ/system/license/printKey fields:
next-renewal-at: When the router will contact the license serverdeadline-at: Final date to renew before upgrade restrictions apply
Scenario: Apply x86 License Key
Section titled âScenario: Apply x86 License KeyâAfter receiving a license key via email or from your MikroTik account:
- Copy the entire license block (including
-----BEGIN...and-----END...) - Paste into terminal or WinBox License dialog
- Reboot the router:
/system/reboot
Scenario: Upgrade License Level
Section titled âScenario: Upgrade License LevelâLicenses can be upgraded (never downgraded):
- x86: Purchase upgrade at mikrotik.com, apply new key
- CHR: Purchase higher tier, assign in portal, run
/system/license/renew
Scenario: Check Available Features
Section titled âScenario: Check Available FeaturesâView feature limits for your license:
/system/license/printOr check specific limits:
/ppp/secret/print count-only/ip/hotspot/user/print count-onlyVerification
Section titled âVerificationâConfirm your license is properly configured:
Check 1: Verify License Level
Section titled âCheck 1: Verify License Levelâ/system/license/printExpected: Correct level displayed (4/5/6 for RouterBOARD, free/p1/p10/p-unlimited for CHR).
Check 2: Verify CHR Renewal (CHR Only)
Section titled âCheck 2: Verify CHR Renewal (CHR Only)â/system/license/printExpected: deadline-at in the future; no âlimited upgradesâ message.
Check 3: Test Upgrade Capability (CHR)
Section titled âCheck 3: Test Upgrade Capability (CHR)â/system/package/update/check-for-updatesExpected: Able to check for updates without âlimited upgradesâ error.
Troubleshooting
Section titled âTroubleshootingâ| Symptom | Cause | Solution |
|---|---|---|
| âLimited upgradesâ on CHR | License renewal failed | Ensure internet access to licence.mikrotik.com; run /system/license/renew |
| CHR shows âfreeâ after purchase | License not renewed on router | Run /system/license/renew after purchasing |
| Purchased license not in account | Trial expired >60 days ago | Create new CHR instance; purchase within trial period |
| License key not accepted (x86) | Wrong software-id or corrupted key | Verify software-id matches; re-copy key from email |
| RouterBOARD shows no license | Storage formatted incorrectly | Contact MikroTik support; $10 replacement fee |
| CHR system-id conflict | Cloned VM with duplicate ID | Run /system/license/generate-new-id on free tier |
| Renewal fails with network error | DNS or firewall blocking | Verify DNS works; allow outbound to licence.mikrotik.com |
| Wrong time causes renewal failure | System clock incorrect | Fix NTP configuration before renewing |
Debug: Check License Server Connectivity
Section titled âDebug: Check License Server Connectivityâ/tool/fetch url="https://licence.mikrotik.com" mode=httpsIf this fails, check DNS and firewall rules.
Debug: View License Renewal Logs
Section titled âDebug: View License Renewal Logsâ/log/print where topics~"system"Look for license-related messages.
Common Mistakes
- Not running
/system/license/renewafter CHR purchase - The router doesnât automatically detect the purchase - Formatting RouterBOARD storage with non-MikroTik tools - Destroys the license permanently
- Letting CHR trial expire without purchase - After 60 days post-trial, the device disappears from your account
- Cloning CHR VMs without generating new ID - Causes system-id conflicts; generate new ID on free tier first
- Blocking
licence.mikrotik.com- CHR needs periodic access for renewal verification
License Level Comparison
Section titled âLicense Level ComparisonâRouterBOARD / x86 Levels
Section titled âRouterBOARD / x86 Levelsâ| Feature | L3 (CPE) | L4 (WISP) | L5 (WISP) | L6 (Controller) |
|---|---|---|---|---|
| Wireless AP | No | Yes | Yes | Yes |
| PPP Tunnels | 200 | 200 | 500 | Unlimited |
| HotSpot Users | 1 | 200 | 500 | Unlimited |
| EoIP Tunnels | 200 | 200 | 500 | Unlimited |
| VLAN Interfaces | 200 | 200 | Unlimited | Unlimited |
| OVPN Tunnels | 200 | 200 | Unlimited | Unlimited |
| User Manager | No | Yes | Yes | Yes |
CHR Levels
Section titled âCHR Levelsâ| Feature | Free | P1 | P10 | P-Unlimited |
|---|---|---|---|---|
| Speed Limit | 1 Mbps | 1 Gbps | 10 Gbps | None |
| All RouterOS Features | Yes | Yes | Yes | Yes |
| IP Cloud | No | Yes | Yes | Yes |
| Perpetual | Yes | Yes | Yes | Yes |
Related Topics
Section titled âRelated TopicsâSystem Management
Section titled âSystem Managementâ- RouterBOARD - hardware and firmware management
- Resources - view system information
- Package Installation - software package management
Cloud Services
Section titled âCloud Servicesâ- IP Cloud - DDNS service (requires paid CHR license)
- System Backup - cloud backup features
Related Topics
Section titled âRelated Topicsâ- User Management - license affects features
- Logging - view license-related messages
Reference
Section titled âReferenceâ- MikroTik License Keys Documentation
- MikroTik CHR Documentation
- MikroTik Client Portal - License management
Key Commands Reference
Section titled âKey Commands Referenceâ| Command | Description |
|---|---|
/system/license/print | View current license status |
/system/license/renew | Activate or renew CHR license |
/system/license/generate-new-id | Generate new system-id (CHR free tier only) |
License Properties
Section titled âLicense Propertiesâ| Property | Type | Description |
|---|---|---|
software-id | string | Device identifier (RouterBOARD/x86) |
system-id | UUID | Device identifier (CHR) |
level | string/integer | License level or tier name |
features | string | Additional licensed features |
next-renewal-at | datetime | Next scheduled renewal check (CHR) |
deadline-at | datetime | Final renewal deadline (CHR) |
Important URLs
Section titled âImportant URLsâ| URL | Purpose |
|---|---|
licence.mikrotik.com | License verification server |
www.mikrotik.com/client/ | Customer portal for purchases |
www.mikrotik.com/download | RouterOS and CHR downloads |