Firmware Image Detail

Overview

The Firmware Image Change page in the CONTROL admin portal is used to configure and manage firmware images for network devices. This page specifically displays the configuration for MikroTik 7.20.8 [MIPSBE] firmware (ID: 411), allowing administrators to define device profiles, upgrade settings, release information, and distribution parameters for firmware deployments.

Key Features

• Firmware Image Configuration: Complete setup of firmware images including name, version, and device compatibility
• Device Profile Assignment: Link firmware to specific device models and hardware types
• Upgrade Profile Management: Define which devices should receive firmware updates based on selectors
• Release Date Control: Schedule when firmware becomes available for automatic updates
• Organization Management: Associate firmware with specific organizations and control public visibility
• File Management: Upload firmware files or provide alternative download URLs
• Version History: Track creation and modification dates for audit purposes

UI Elements

Header Section

• Page Title: "MikroTik 7.20.8 [MIPSBE] ID: 411"
• Timestamp Information:
  • Created: Feb 10, 2026, 02:58:51 6:18 PM
  • Last change: Feb 10, 2026, 02:58:51 6:18 PM
• Action Buttons:
  • History (blue): View revision history
  • Refresh (blue): Reload page data

Image Settings Form

Basic Information Fields

Name

• Text field displaying: "MikroTik 7.20.8 [MIPSBE]"
• Identifies the firmware image in the system

ID

• Read-only field showing: "411"
• Unique identifier for this firmware image

Is Active

• Checkbox (checked): Indicates firmware is currently active and available for deployment

Version

• Text field showing: "7.20.8"
• Help text: Explains version matching requirements for automatic updates and downgrades

Device and Upgrade Configuration

Device profile

• Tag-based selector displaying: "Mikrotik - RB952UI-5ac2nD - cfg: mtgeneric df1"
• Blue close button (×) to remove profile
• Plus button (+) to add additional profiles
• Help text: "Device profiles this firmware will auto-apply to"

Upgrade profile

• Dropdown menu: "Click for options"
• Expandable/collapsible selector with plus (+) and minus (-) buttons
• Copy button for profile duplication

File

• Currently shows: "firmware/1d7d5fdbf21bce6rie5-7-20-8-mipsbe.npk" (clickable link)
• Choose File button with "No file chosen" status
• Clear button to remove current file
• Labeled as "Change:" to indicate file upload option

URL

• Text field (empty in screenshot)
• Help text: "Alternative URL where file can be downloaded. Used only if and when the file option is not specified."

Release date

• Date field showing: "2026-01-30"
• Help text: Explains automatic update scheduling based on this date

Selector Fields

Apply to selector

• Dropdown menu: "Click for options"
• Help text: Defines matching method for device software version comparison
• Used for "Equal or selector" logic

Apply to (version)

• Text field (empty)
• Help text: Specifies device software version requirements (leave blank for all versions)

Hardware version

• Text field (empty)
• Help text: Specifies device hardware version requirements (leave blank for all hardware versions)

Factory

• Checkbox (unchecked)
• Help text: "Activate the factory reset option on the devices after sending the firmware upgrade command"

Organization Settings

Organization

• Dropdown showing: "Zequenze"
• Associates firmware with specific organization

Is public

• Checkbox (unchecked)
• Controls visibility across organizations

Description

• Text area (empty)
• For adding detailed firmware notes or documentation

Order

• Numeric field showing: "165"
• Controls display priority/sorting order

Important Dates Section

Collapsible section displaying:

• Last change: Feb. 10, 2026, 2:58 p.m.
• Created: Feb. 10, 2026, 2:58 p.m.

Actions Available

Bottom Action Bar

Save (Blue button)

• Saves all changes to the firmware image configuration

Delete (Red button)

• Removes the firmware image from the system
• Use with caution as this action may be irreversible

Close (Gray button with X)

• Closes the page without saving changes

Save and close (Blue button)

• Saves changes and returns to the previous page

Save and add another (Blue button)

• Saves current configuration and opens a new blank form for adding another firmware image

User Interactions

Configuring Firmware Images

1. Basic Setup:

   • Enter a descriptive name for the firmware
   • Specify the exact version number
   • Activate/deactivate using the "Is active" checkbox

2. Assigning Device Profiles:

   • Click the plus (+) button next to "Device profile"
   • Select applicable device models from the picker
   • Multiple profiles can be assigned
   • Remove profiles using the × button on each tag

3. Upload Firmware File:

   • Click Choose File button
   • Select the firmware .npk file from local storage
   • Alternative: Provide a URL in the URL field for remote downloads

4. Setting Release Parameters:

   • Enter release date to control when automatic updates begin
   • Configure "Apply to selector" and version filters for targeted deployments
   • Optionally specify hardware version requirements

5. Organization Assignment:

   • Select the owning organization from dropdown
   • Check "Is public" to make firmware visible across organizations
   • Add description for documentation purposes

Navigation

Access Path

• CONTROL admin portal (dev) → Firmware → Images → Select specific image

Left Sidebar Menu

Users can navigate to other sections:

• Dashboard
• Inventory
• Firmware (expanded)
  • Images (current)
  • Profiles
  • Logs
  • Reports
• Devices
• Locations
• Files
• Organization
• Settings
• User log

Breadcrumb Navigation

• Home → Firmware → Images

Data Displayed

Configuration Metadata

• Firmware identification: Name, ID, version
• Status: Active/inactive state
• File information: Current firmware file path or URL
• Compatibility: Device profiles, hardware versions, software versions
• Deployment settings: Release date, upgrade profiles, selectors
• Organization ownership: Assignment and visibility settings
• Audit trail: Creation and modification timestamps

Device Profile Tags

Display format includes:

• Manufacturer (Mikrotik)
• Model (RB952UI-5ac2nD)
• Configuration type (cfg: mtgeneric df1)

Notes/Tips

Best Practices

1. Version Matching: Ensure the version field exactly matches the version reported by devices to enable proper automatic updates and downgrades

2. Device Profile Assignment: Always assign at least one device profile to ensure the firmware can be properly matched to compatible devices

3. Release Date Strategy: Set future release dates to schedule automatic rollouts; leave blank or set past date for immediate availability

4. File vs URL: Upload files for internal hosting or use URLs for external repositories. The system prioritizes uploaded files over URLs.

5. Testing Before Activation: Configure firmware settings while "Is active" is unchecked, test with specific devices, then activate for broader deployment

6. Factory Reset Option: Use the "Factory" checkbox cautiously as it will reset devices to factory defaults after upgrade

7. Order Value: Use the order field to control how firmware images are prioritized in lists and selection interfaces

Important Warnings

• Version Accuracy: Incorrect version numbers may prevent automatic updates from working correctly
• Device Profile Requirement: Firmware without device profiles won't auto-apply to any devices
• Deletion Impact: Deleting firmware images may affect scheduled upgrades and device configurations
• Factory Reset: Enabling factory reset will erase device configurations after firmware installation

Technical Notes

• The .npk file format is specific to MikroTik RouterOS devices
• The [MIPSBE] designation indicates MIPS Big-Endian architecture compatibility
• Device profiles use composite identifiers including model and configuration type
• The system supports both push (immediate) and pull (scheduled) firmware deployment models