# Clarification on Extracting a Single Project from Ignition Gateway Backup (.gwbk)

**URL:** <https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607>\
**Category:** Ignition\
**Created:** [December 4, 2025, 7:05am UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607 "2025-12-04T07:05:19Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![Prasanth\_A](https://avatars.discourse-cdn.com/v4/letter/p/b38774/32.png) [@Prasanth\_A](https://forum.inductiveautomation.com/u/Prasanth_A)\
**Post date:** [December 4, 2025, 7:05am UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/1 "2025-12-04T07:05:19Z")

</div>

Hello Team,

I have a few-month-old Ignition Gateway backup in `.gwbk` format. In that backup, there is one particular project I need. Currently, the live server gateway contains many new projects, so I do not want to restore the entire old backup and overwrite the existing configuration.

My requirement is:

- Extract only the specific project from the `.gwbk` backup.

- Convert it into a format (e.g., ZIP) that can be imported into the current gateway.

- Import this project without deleting existing scripts and logic.

- Maintain all scripts and logic intact during the process.

Could you please confirm:

1. Is it possible to extract a single project from a `.gwbk` file without restoring the entire gateway?

2. If yes, what is the recommended approach or tool for converting and importing that project?

3. Are there any official guidelines or best practices for this scenario?

I have tried one method:  
I converted the entire `.gwbk` backup file into a ZIP, fetched the project folder, copied it to another folder on my local PC, then converted that particular project into a ZIP file and imported it into the gateway. Finally, when I tried to open the project in Designer, the UI screens, logic, and scripts were all missing.

Your guidance will help me understand the limitations and possibilities of Ignition Gateway backups.

Thank you for your support.

---

<div class="post-metadata">

**Author:** ![Lynn\_Martineau](https://avatars.discourse-cdn.com/v4/letter/l/f1d935/32.png) [@Lynn\_Martineau](https://forum.inductiveautomation.com/u/Lynn_Martineau)\
**Post date:** [December 4, 2025, 1:22pm UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/2 "2025-12-04T13:22:15Z")

</div>

It may not be the “best” method, but what I have done for this situation is restore the .`gwbk` file onto a different server, usually my local workstation, then export the needed project `.zip` file. Last, import the project `.zip` file on the server where you need it.

---

<div class="post-metadata">

**Author:** ![pturmel](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/pturmel/32/3295_2.png) [@pturmel](https://forum.inductiveautomation.com/u/pturmel)\
**Post date:** [December 4, 2025, 1:24pm UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/3 "2025-12-04T13:24:41Z")

</div>

What Lynn says. Spin up a VM or docker container for temporary Ignition server and restore the gateway backup there. Then export just the project.

(It is wise to always use VMs or containers for Ignition gateways in development.)

---

<div class="post-metadata">

**Author:** ![paul-griffith](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/paul-griffith/32/37249_2.png) [@paul-griffith](https://forum.inductiveautomation.com/u/paul-griffith)\
**Post date:** [December 4, 2025, 4:42pm UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/4 "2025-12-04T16:42:29Z")

</div>

[Kindling](https://github.com/inductiveautomation/kindling) can do this with a graphical interface:

If you open up a .gwbk and then navigate to the root of a project folder there's a button to export the project as a separate zip:

 ![image](https://us1.discourse-cdn.com/inductiveautomation/original/3X/f/1/f169a6ace8f062710bda93a21216b3d21c4b389f.png)

All a project export zip is, though, is a zip of that project folder, so there's no need for any custom logic. Extract the project folder from the gwbk yourself and zip it back up - it'll make no difference to Ignition where it came from.

---

<div class="post-metadata">

**Author:** ![Prasanth\_A](https://avatars.discourse-cdn.com/v4/letter/p/b38774/32.png) [@Prasanth\_A](https://forum.inductiveautomation.com/u/Prasanth_A)\
**Post date:** [December 5, 2025, 8:31am UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/5 "2025-12-05T08:31:49Z")

</div>

Hi Paul,

Thank you for your support.

If you don’t mind, could you please explain this logic in detail? I want to make sure that if I follow this approach, I can convert the project into a ZIP file and import it into the live gateway without losing any scripts or logic associated with the project.

---

<div class="post-metadata">

**Author:** ![Prasanth\_A](https://avatars.discourse-cdn.com/v4/letter/p/b38774/32.png) [@Prasanth\_A](https://forum.inductiveautomation.com/u/Prasanth_A)\
**Post date:** [December 5, 2025, 8:37am UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/6 "2025-12-05T08:37:12Z")

</div>

Hi Lynn,

Thank you for your support.

I tried the suggested approach, but I encountered some issues. My production gateway contains multiple projects and a large number of tags for both Perspective and Vision. When I attempt to restore my local Ignition backup, the process takes a very long time and eventually fails with an error. As a result, the restore does not work.

Could you please suggest any alternative options to achieve this without errors?

---

<div class="post-metadata">

**Author:** ![bschroeder](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/bschroeder/32/13260_2.png) [@bschroeder](https://forum.inductiveautomation.com/u/bschroeder)\
**Post date:** [December 5, 2025, 12:09pm UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/7 "2025-12-05T12:09:12Z")

</div>

What errors?

Do you have the memory setup the same on both gateways in ignition.conf?

---

<div class="post-metadata">

**Author:** ![paul-griffith](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/paul-griffith/32/37249_2.png) [@paul-griffith](https://forum.inductiveautomation.com/u/paul-griffith)\
**Post date:** [December 5, 2025, 3:45pm UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/8 "2025-12-05T15:45:01Z")

</div>

There's not much to explain.

Take the .gwbk.  
Open it as a ZIP file in whatever archive management tool you use.  
Navigate to the root project directory.  
Extract it out of the ZIP.  
Create a new ZIP containing that whole directory.  
The root folder of the zip should have the name of your project. Then within that one folder there must be the `project.json` manifest file, and a bunch of folders identifying the other project resources underneath that.

Again, if you want an easy way to do it you can use Kindling, which provides a graphical user interface.

> [@Prasanth\_A](#):
>
> eventually fails with an error.

The nature of this error completely changes what the advice for resolution is.

* * *

In general, if you want specific step by step advice working through something with Ignition because you're not confident - you should be contacting our [Support department](https://support.inductiveautomation.com/hc/en-us) officially.

---

<div class="post-metadata">

**Author:** ![Prasanth\_A](https://avatars.discourse-cdn.com/v4/letter/p/b38774/32.png) [@Prasanth\_A](https://forum.inductiveautomation.com/u/Prasanth_A)\
**Post date:** [December 6, 2025, 6:58am UTC](https://forum.inductiveautomation.com/t/clarification-on-extracting-a-single-project-from-ignition-gateway-backup-gwbk/112607/9 "2025-12-06T06:58:04Z")

</div>

Thanks Paul !
