GL-X300B Firmware Update Guide: Online & Local Upgrade

The GL-X300B firmware upgrade update process offers two main methods to keep your Collie router current with the latest features and security patches. You can update remotely using the online upgrade feature if you have an internet connection, or upload firmware files locally if your connection is limited. Understanding the differences between release, clean, and testing firmware versions ensures you choose the right build for your needs.

Understanding GL-X300B Firmware Versions

Current Firmware Version Identification

Before starting any GL-X300B firmware upgrade, you need to identify what version your router is currently running. Access the UPGRADE menu in your web admin panel at http://192.168.8.1. The current firmware version displays prominently, along with the compile time stamp showing when that specific build was created.

Release vs Clean vs Testing Versions

GL.iNet provides three distinct firmware channels for the Collie (GL-X300B), each serving different user needs:

All official firmware files are available from GL.iNet’s server at http://download.gl-inet.com/firmware/x300b/. Each folder contains the appropriate .tar files for upload through the web interface.

Firmware Compatibility Requirements

The GL-X300B accepts firmware files in .tar format only through the web upload interface. The .img format files can only be used through Uboot recovery mode if you need to restore a bricked device. Always verify you’re downloading the correct firmware for the GL-X300B model—using firmware from other GL.iNet routers will not work and can brick your device.

Compile Time and Last Update Information

Each firmware version includes a compile timestamp in the version information. This shows you exactly when GL.iNet built that firmware release. Comparing your current compile time with available updates helps you determine how long your router has been running the same build and whether critical security patches have been released since your last update.

Online Firmware Upgrade Process

Checking Internet Connection Requirements

The online upgrade feature requires a stable internet connection throughout the entire process. Verify your GL-X300B is connected to the internet before attempting an online firmware upgrade. Check the status panel—your WAN connection should show an active IP address. If you’re using 3G/4G modem mode or connected via repeater, ensure the connection is stable and has adequate bandwidth (at least 1-2 Mbps recommended for download speeds).

Accessing Online Upgrade Menu

Log into your router’s web admin panel and navigate to the UPGRADE section. Click the Online Upgrade tab. The system automatically detects your current firmware version and compares it against GL.iNet’s servers. If you’re connected to the internet, the panel will display any available updates for your GL-X300B model.

Automatic Version Detection

The online upgrade interface performs automatic version checking. The system queries GL.iNet’s firmware repository and displays the latest available version in your selected release channel. If a newer version exists, you’ll see the new version number, release notes, and a download/install button. If you’re already running the latest version, the interface confirms this status.

Keep Settings Option Explained

An important checkbox appears during the online upgrade process: “Keep settings after the firmware upgrade.” GL.iNet recommends leaving this unchecked for most users. When you keep settings, your current configuration (WiFi credentials, firewall rules, VPN settings, etc.) persists after the upgrade. However, if the new firmware version has structural changes to configuration files, keeping old settings can cause conflicts and create performance issues or even prevent the router from functioning properly.

Only enable “Keep settings” if you have a complex configuration you’ve tested thoroughly and are confident the new firmware maintains the same settings structure. If you encounter problems after an upgrade with settings kept, you can always revert and perform a factory reset using the Revert Firmware option in the MORE SETTINGS menu.

Download and Installation Timeline

The GL-X300B firmware file typically ranges from 10-50 MB depending on the version. Download time depends on your internet speed—at 5 Mbps, a 20 MB file downloads in roughly 30-40 seconds. After the download completes, the router automatically begins the installation process, which usually takes 2-5 minutes. During installation, the router may reboot multiple times. Do not power off the device or disconnect the power cable during this process, as an interrupted firmware installation can leave your router unbootable.

Keep the admin panel open during the process so you can monitor progress. Once the installation completes successfully, you’ll see the new firmware version displayed in the UPGRADE menu. The router will maintain your internet connection and WiFi settings (if you enabled Keep settings), though you may need to reconnect wireless clients.

Local Firmware Upload Method

Downloading Official Firmware from GL.iNet

If your GL-X300B lacks internet connectivity or you prefer to manually download and verify firmware before installation, use the local upload method. Navigate to http://download.gl-inet.com/firmware/x300b/ in your web browser. You’ll see three main folders:

• release/ – Contains the official stable OpenWrt/LEDE firmware with all GL.iNet features
• clean/ – Contains minimal firmware with only the Luci admin interface
• testing/ – Contains beta versions for testing new features

Browse to your desired folder and locate the firmware file for GL-X300B. Firmware files are typically named something like openwrt-x300b-squashfs-sysupgrade.tar. Download the file to your computer and note its location.

Firmware File Format Requirements (.tar vs .img)

The GL-X300B’s web interface only accepts .tar files for local uploads. These are compressed firmware packages that the router’s upgrade script can parse and install. The .img format files available on GL.iNet’s server are raw disk images used exclusively for Uboot recovery mode—attempting to upload an .img file through the web interface will result in an error and failed installation.

Always verify you’re downloading a .tar file before proceeding. If you accidentally download a .img file and need to use it, you would need to access the router through Uboot mode using a serial console connection, which is an advanced recovery procedure covered in the troubleshooting section.

Drag and Drop Upload Interface

Return to your router’s web admin panel and navigate to UPGRADE > Local Upgrade. You’ll see a clearly marked drop zone with instructions to upload your firmware file. Simply drag the .tar firmware file from your computer’s file explorer and drop it directly into this area. The browser uploads the file to the router without requiring any additional button clicks.

Alternatively, if drag-and-drop doesn’t work with your browser, click in the upload zone to open a file browser dialog, navigate to your downloaded firmware file, and click Open. The upload begins automatically.

Installation Progress Monitoring

Once the file upload completes (you’ll see a confirmation message), the router automatically begins the installation process. The admin panel displays a progress indicator showing the installation status. The router will reboot automatically during installation—this is normal and expected. The entire local installation process typically takes 3-7 minutes depending on your hardware and the firmware size.

Do not interrupt the power supply during this process. If the router becomes unresponsive for more than 10 minutes after the upload completes, the installation may have failed. In this case, see the troubleshooting section on firmware recovery.

Auto Upgrade Configuration

Enabling Automatic Updates

The GL-X300B includes an automatic firmware update feature that checks for and installs updates on a schedule you define. Navigate to UPGRADE > Auto Upgrade in the web admin panel. You’ll see a toggle switch to enable automatic upgrades. Check this box to activate the feature.

When enabled, the router automatically checks GL.iNet’s firmware server daily at your specified time. If a newer firmware version is available in your selected release channel, the router downloads and installs it without any action required from you.

Setting Upgrade Schedule Time

The Auto Upgrade interface provides a time selector where you can specify when the upgrade should occur. Select a time when your router isn’t critical to your network operations—early morning hours like 2:00 AM or 3:00 AM work well for most users. The upgrade process takes 5-10 minutes total, during which internet connectivity will be temporarily unavailable.

Set your preferred time and save the settings. The router will use this schedule to check for and install firmware updates automatically. There’s no limit to how frequently the router checks; it will perform automatic upgrades whenever a new version is released and your scheduled time arrives.

Router Time Synchronization

The auto upgrade schedule relies on your router’s internal clock being accurate. Verify that you’ve set the correct Time Zone in MORE SETTINGS > Time Zone. The router synchronizes its time with NTP servers once it connects to the internet, but if your timezone is configured incorrectly, the scheduled upgrade time will be off.

For example, if you set the upgrade time to 2:00 AM but your timezone is configured as UTC when you’re actually in EST, the upgrade will occur at 7:00 AM your local time instead. Always verify your timezone setting before relying on automatic upgrades.

Canceling Scheduled Upgrades

If you need to disable automatic upgrades temporarily or permanently, return to UPGRADE > Auto Upgrade and uncheck the enable toggle. This immediately stops the router from checking for available updates. You can re-enable it at any time by checking the toggle again.

If an automatic upgrade has already begun (you see the installation progress screen), you cannot cancel it mid-process. The installation must complete before you can interact with the router. However, you can prevent future automatic upgrades by disabling the feature before the next scheduled check time.

Firmware Release Channels Explained

Release: Stable Official Firmware

The Release channel provides GL.iNet’s official, fully-tested OpenWrt/LEDE firmware with all standard features and GL.iNet applications pre-installed. This includes cloud management, VPN capabilities, firewall configuration, and all web admin panel features. Release firmware goes through extensive testing before publication, making it the most stable option for production use.

For most users, the Release channel is the recommended choice. It balances stability with feature completeness. Updates to Release firmware are published quarterly or as critical security patches become available.

Clean: Luci Admin Only Version

The Clean firmware channel provides a minimal OpenWrt/LEDE build with only the Luci web admin interface and no GL.iNet custom applications or packages. This version uses significantly less storage and RAM, making it suitable for users with limited device resources or those who want a stripped-down system.

Clean firmware is useful for advanced users who want to build their own custom router configuration from scratch without removing pre-installed GL.iNet packages. However, features like remote cloud management and some simplified setup wizards won’t be available.

Testing: Beta Version Features

The Testing channel contains beta versions of upcoming GL.iNet firmware with new features, performance improvements, and experimental functionality. These versions are less thoroughly tested than Release builds and may contain bugs or compatibility issues.

Use Testing firmware only if you want to evaluate new features and are comfortable troubleshooting issues. Never deploy Testing firmware on production routers or in critical network environments. If you upgrade to Testing firmware and encounter problems, you can always downgrade to the latest Release version using the local upload method.

Compiling Custom Firmware via GitHub

For advanced users, GL.iNet provides an ImageBuilder repository on GitHub that allows you to compile custom firmware with specific packages and configurations. Visit https://github.com/gl-inet/imagebuilder for documentation and build instructions.

Custom-compiled firmware is useful for adding or removing specific packages, customizing default settings, or creating firmware tailored to your exact requirements. However, custom builds are unsupported by GL.iNet support, and you’re responsible for ensuring stability and compatibility. Always test custom firmware on a non-production device first.

Troubleshooting Firmware Issues

Keep Settings After Upgrade Problems

If you enabled “Keep settings” during a firmware upgrade and the router now behaves erratically, won’t connect to the internet, or displays error messages, the old settings likely conflict with the new firmware version’s configuration structure.

The solution is to perform a factory reset: Navigate to MORE SETTINGS > Revert Firmware and click the reset button. Confirm the action—this erases all settings, applications, and data, restoring the router to factory defaults. The firmware version remains unchanged; only your configuration is reset. After the reset completes, reconfigure your internet connection, WiFi credentials, and other settings from scratch.

Bricked Router Recovery with Uboot

If a firmware installation fails or you accidentally uploaded an incompatible firmware file, your router may become unresponsive or unbootable—commonly called “bricking.” The GL-X300B includes a Uboot bootloader that provides a recovery mechanism even when the main firmware is corrupted.

Recovery via Uboot requires:

• A computer with a USB-to-serial adapter (3.3V TTL serial interface)
• A terminal emulator application (PuTTY, minicom, or similar)
• An official .img firmware file from GL.iNet’s server
• Knowledge of serial port communication

This is an advanced procedure requiring physical access to the router’s serial port. If you’re uncomfortable with serial communication, contact GL.iNet support with your router model and firmware file name. They can provide step-by-step recovery guidance or arrange a return for professional recovery.

Incompatible Firmware Installation

Attempting to flash firmware compiled for a different GL.iNet router model to your GL-X300B will fail or brick the device. Always verify the firmware filename and model designation before uploading. GL-X300B firmware files explicitly contain “x300b” or “Collie” in their filename.

If you’ve already uploaded the wrong firmware, stop immediately and do not reboot the router. Use the local upload method to install the correct firmware for your GL-X300B model. If the router has already rebooted with the wrong firmware, Uboot recovery is necessary.

Reverting to Factory Settings

The Revert Firmware option in MORE SETTINGS resets the router to its factory default state, erasing all user configurations. This is different from a firmware downgrade—it keeps your current firmware version but resets all settings to defaults.

This is useful if you’ve made configuration changes that caused network problems and want to start fresh with the current firmware version. After reverting, the router defaults to:

• Admin password: None (set a new password on first login)
• WiFi SSID: GL-X300B-XXX (printed on device label)
• WiFi Password: goodlife
• LAN IP: 192.168.8.1
• DHCP enabled on LAN
• No WAN connection configured

Post-Upgrade Configuration

Resetting Admin Password After Update

After a major firmware upgrade, especially if you performed a factory reset, you’ll need to set a new admin password. If you disabled “Keep settings” during the upgrade, the password is cleared.

Log into the web admin panel at http://192.168.8.1. If no password is set, you’ll proceed directly to the admin panel or be prompted to set one. Navigate to MORE SETTINGS > Admin Password. Enter your desired password (minimum 5 characters) and click Submit. This password protects both the web admin panel and the embedded Linux system SSH access.

Choose a strong password with a mix of characters. This password is independent of your WiFi password—changing one doesn’t affect the other.

Re-entering WiFi Settings

If you disabled “Keep settings” during the firmware upgrade, your WiFi configuration is reset to defaults. Reconnect to the WiFi network using the default credentials:

• SSID: GL-X300B-XXX (look at the sticker on your router for the XXX)
• Password: goodlife

Once connected, log into the web admin panel and navigate to WIRELESS > Modify to set your preferred WiFi name and password. Change both the SSID and Wi-Fi Key to your desired values. The Wi-Fi Key must be at least 8 characters long. Consider enabling SSID hiding if you want additional privacy.

Also reconfigure your internet connection in the INTERNET section—select Cable, Repeater, or 3G/4G Modem depending on your setup. If you’re using a 3G/4G modem, reinsert your SIM card if necessary and perform the Auto Setup or Manual Setup for your carrier.

Verifying All Features Work

After an upgrade and reconfiguration, test critical functions to ensure everything operates correctly:

• Internet connectivity: Verify you can browse websites from a connected client device
• WiFi performance: Check signal strength and throughput from various locations
• Security features: Confirm firewall rules and port forwarding still function if you manually re-entered them
• Modem connection (if applicable): For 3G/4G users, verify the modem registers on the network and maintains a stable connection
• VPN (if configured): Test OpenVPN or WireGuard connections if you use them

Reboot the router once after reconfiguring to ensure all settings persist and there are no startup issues. If you notice any problems, consult the troubleshooting section or downgrade to your previous firmware version using the local upload method and report the issue to GL.iNet support.

Frequently Asked Questions

How often does GL.iNet release firmware updates for the GL-X300B?

GL.iNet typically releases major firmware updates quarterly, with security patches and bug fixes released as needed. The Release channel receives fully-tested updates, while the Testing channel receives experimental versions more frequently. Enable Auto Upgrade with notifications if you want to stay current without manual checking.

Can I downgrade to an older firmware version if the new version causes problems?

Yes, you can downgrade using the local upload method. Download the older firmware .tar file from http://download.gl-inet.com/firmware/x300b/ and upload it through the Local Upgrade interface. Downgrading erases current settings, so note any important configurations before downgrading. Always downgrade to a tested Release version rather than Testing versions unless troubleshooting a specific issue.

What should I do if the firmware upgrade fails halfway through?

If the upgrade fails and the router becomes unresponsive, do not reboot. Wait 10 minutes to see if it recovers automatically. If still unresponsive, the router may require Uboot recovery using a serial connection and .img firmware file. If you’re unfamiliar with serial recovery, contact GL.iNet support with your router model and the exact firmware file you were upgrading to. They can assist with recovery procedures.

Is it safe to leave Auto Upgrade enabled all the time?

Yes, automatic upgrades are safe. The router automatically downloads and installs updates on your specified schedule, typically during off-hours when network demand is low. The only risk is temporary internet unavailability for 5-10 minutes during the upgrade. If your network needs to remain online 24/7, schedule auto upgrades during your lowest-usage period or disable the feature and perform manual updates on your preferred schedule.

Why do I need different firmware versions (Release, Clean, Testing) instead of just one?

Different users have different needs. Release firmware suits most users with full features and stability. Clean firmware serves advanced users who want minimal bloat and build their own configuration. Testing firmware lets early adopters evaluate new features before release. This flexibility allows GL.iNet to serve diverse user bases with appropriate firmware for each use case.