# Firmware Image Detail

![Screenshot - MikroTik 7.20.8 [MIPSBE]](https://docs.zequenze.com/uploads/images/gallery/2026-02/WMmncrQmQk0fghSs-control-dev-zequenze-com-admin-firmware-image-411-change-20260213-174443.png)

## 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