# How to Export/Import Backup Configuration Files via LuCI

**URL:** <https://forum.gl-inet.com/t/how-to-export-import-backup-configuration-files-via-luci/68190>\
**Category:** Router\
**Tags:** KB\
**Created:** [April 17, 2026, 4:22am UTC](https://forum.gl-inet.com/t/how-to-export-import-backup-configuration-files-via-luci/68190 "2026-04-17T04:22:15Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![will.qiu](https://forum-assets.gl-inet.com/letter_avatar_proxy/v4/letter/w/b38774/32.png) [@will.qiu](https://forum.gl-inet.com/u/will.qiu)\
**Post date:** [April 17, 2026, 4:22am UTC](https://forum.gl-inet.com/t/how-to-export-import-backup-configuration-files-via-luci/68190/1 "2026-04-17T04:22:15Z")

</div>

### **Introduction**

When using a GL.iNet router, you may need to back up your current system configurations or restore previous settings after a reset or firmware upgrade. This guide will walk you through how to export and import your router's backup configuration files via LuCI.

* * *

### **Part 1: How to Export Backup Configuration Files via LuCI**

**Step 1: Access the LuCI Advanced Settings**  
Log into your GL.iNet router's web Admin Panel (the default IP address is usually `192.168.8.1`). On the left-hand menu, navigate to **System** -\> **Advanced Settings**. Click the link provided on the page to redirect and log into the LuCI interface.

For more details about Luci, please refer to: [What is LuCI - GL.iNet Router Docs 4](https://docs.gl-inet.com/router/en/4/faq/what_is_luci/)

**Step 2: Navigate to the Backup / Flash Firmware Page**  
Once you are in the LuCI interface, click on **System** in the top menu bar, and then select **Backup / Flash Firmware** from the dropdown menu.

 ![image](https://forum-static.gl-inet.com/original/3X/4/1/41871e9e7e67ea14c6d0bcb292326f16ad53f1df.png)  
_Reference Steps: Screenshot from Flint 2 (MT6000) v4.8.4_

**Step 3: Generate and Download the Backup File**  
Under the "Backup / Restore" tab, locate the "Backup" section. Click the **Generate archive** button.

 ![image](https://forum-static.gl-inet.com/original/3X/f/1/f103aa060d7ac762062b8d695d84842c09fcc4f0.png)  
_Reference Steps: Screenshot from Flint 2 (MT6000) v4.8.4_

Your web browser will automatically download a compressed archive (usually in `.tar.gz` format) containing all your current configuration files to your local computer. Please keep this file safe and we also recommend to rename it with the current firmware version.

* * *

### **Part 2: How to Import Backup Configuration Files via LuCI**

**Step 1: Prepare for Restoration**  
If you have just reset your router or need to restore previous settings, log into the LuCI interface using the same method described above, and navigate to the **System** -\> **Backup / Flash Firmware** page.

**Step 2: Upload the Backup File and Restore**  
In the "Restore backup" section of the page, click the **Choose File** (or Browse) button and select the `.tar.gz` backup file you previously exported to your computer.  
Once selected, click the **Upload archive...** button next to it. The system will automatically parse the file and apply your configurations. After the restoration is complete, the router will usually need to reboot for all settings to take effect.

 ![image](https://forum-static.gl-inet.com/original/3X/e/9/e9de3c8bb3bee555ec75cdb5043b17739c78f5b8.png)  
_Reference Steps: Screenshot from Flint 2 (MT6000) v4.8.4_

* * *

### **Part 3: Optional Items**

#### **Check the Backup List:**

Before generating the backup, you can check exactly which files will be included. Click on the **Configuration** tab on the same page and then click the **Open list...** button.

 ![image](https://forum-static.gl-inet.com/original/3X/5/3/534d86eef64be6f5db8c8d2809577423808b085e.png)  
_Reference Steps: Screenshot from Flint 2 (MT6000) v4.8.4_

Here, you will see the list of all file paths slated for backup.

 ![image](https://forum-static.gl-inet.com/original/3X/5/2/52e1f5089dec125a0491e255c5b1edea15776e49.png)  
_Reference Steps: Screenshot from Flint 2 (MT6000) v4.8.4_

#### **Customize the Backup List:**

If you have custom scripts or specific files that need to be included, you can manually add their full file paths to this list.

 ![image](https://forum-static.gl-inet.com/original/3X/d/2/d2b702f489bfd29380ce6be37652de1fb3f3da35.png)  
_Reference Steps: Screenshot from Flint 2 (MT6000) v4.8.4_

* * *

### **Important Notes**

To ensure your device runs stably and to avoid potential network issues, please keep the following in mind when performing these operations:

1. **DO NOT Import Backup Files Across Different Firmware Versions**  
Because the underlying configuration structure may change between different firmware versions (especially major updates), importing a backup across different versions can easily lead to system conflicts, network disconnections, or broken features. It is highly recommended to only backup and restore between the **same firmware versions**.

2. **Plugins Are Not Retained**  
This backup function only targets the router's "configuration files" (such as network settings, firewall rules, etc.). It **does not** back up the actual installation files for any third-party plugins or software packages you have manually installed (such as themes or special utility plugins). **However, their configuration files are retained** (provided they follow standard OpenWrt directory paths). After restoring the backup, you simply need to reinstall the plugins manually. Once installed, the plugins will automatically detect and apply your previous configurations. (Note: If a plugin uses non-standard paths, its config might still be lost unless you manually added it to the Backup List).

3. **Check the Exported Backup File Size**  
After exporting, please make sure to check the file size of the backup archive on your computer. If the file size is unusually large (for example, if it accidentally included non-configuration cache files or logs), it may **fail to work properly** during the import process due to memory limits, or even cause the router to crash. A normal configuration file is typically only a few tens to a few hundreds of KB in size.

---

<div class="post-metadata">

**Author:** ![will.qiu](https://forum-assets.gl-inet.com/letter_avatar_proxy/v4/letter/w/b38774/32.png) [@will.qiu](https://forum.gl-inet.com/u/will.qiu)\
**Post date:** [April 17, 2026, 11:04am UTC](https://forum.gl-inet.com/t/how-to-export-import-backup-configuration-files-via-luci/68190/2 "2026-04-17T11:04:28Z")

</div>



---

<div class="post-metadata">

**Author:** ![stevecharmer](https://forum-assets.gl-inet.com/letter_avatar_proxy/v4/letter/s/d78d45/32.png) [@stevecharmer](https://forum.gl-inet.com/u/stevecharmer)\
**Post date:** [April 30, 2026, 3:48pm UTC](https://forum.gl-inet.com/t/how-to-export-import-backup-configuration-files-via-luci/68190/4 "2026-04-30T15:48:07Z")

</div>

Please explain more.

If I am running firmware version 4.8.3, and after logging into the web interface, i am prompted to upgrade the firmware to version 4.8.4,

1. is that upgrade going to overwrite my settings, my custom shell scripts?
2. i do not remember if the upgrade prompt warns me about losing apps and scripts and encourages a backup first. does it?
3. then after I have my backup, and i upgrade the firmware, is that backup now obsolete and i can’t restore it because the firmware is different?
4. and if the firmware upgrade erases my apps and scripts, but i can’t restore the backup due to firmware version differences, how do it get the apps and scripts back?

---

<div class="post-metadata">

**Author:** ![will.qiu](https://forum-assets.gl-inet.com/letter_avatar_proxy/v4/letter/w/b38774/32.png) [@will.qiu](https://forum.gl-inet.com/u/will.qiu)\
**Post date:** [May 6, 2026, 6:49am UTC](https://forum.gl-inet.com/t/how-to-export-import-backup-configuration-files-via-luci/68190/5 "2026-05-06T06:49:20Z")

</div>

Hi,

Please see our responses below:

1. It depends on the case:

2. Yes, since third-party plugins and custom scripts are not officially supported, there will be no related prompts in the GL.iNet UI.

3. You can try upgrading the firmware while keeping the configuration. If everything works properly, you can then create a backup for future use.

4. 
  - For applications, you can refer to this thread to export a list before upgrading and reinstall them afterward:  
[HOW-TO: Script: List My OPKGs (to a file for backup) - #6](https://forum.gl-inet.com/t/how-to-script-list-my-opkgs-to-a-file-for-backup/30963/6)
  - For scripts, you can refer to **Part 3: Optional Items → Customize the Backup List** to add them to the backup list so they are preserved during firmware upgrades. Be sure to verify that they still work correctly after the upgrade.

---

<div class="post-metadata">

**Author:** ![system](https://forum-static.gl-inet.com/original/3X/7/7/77e28f6cb342ac4bd641bd9a6254595d61b2812a.png) [@system](https://forum.gl-inet.com/u/system)\
**Post date:** [August 20, 2026, 1:51am UTC](https://forum.gl-inet.com/t/how-to-export-import-backup-configuration-files-via-luci/68190/7 "2026-08-20T01:51:40Z")

</div>

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.
