User Manual









Sepasoft - MES Modules
Cirrus Link - MQTT Modules


Inductive University
Ignition Demo Project
Knowledge Base Articles
IA Support


Ignition 8.1. Offline Version (04/2021)
Ignition 8 Online Version
Ignition 7.9 Online Version
Ignition 7.8 Online Version

Deprecated Pages

SDK Documentation


Sign In

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Gateway Backups vs Project Exports

It is a good idea to create backups anytime you make changes to Ignition. There There are two main types of backups available in Ignition: Gateway backups and Project exports. You can choose to backup up everything, or be selective about what you want to backup and restore. Ignition is designed to be architecture agnostic or compatible across all platforms. This is particularly helpful when you want to restore your Gateway on a new machine or platform.  Gateway  Gateway backups are all inclusive and while Project exports are simply a backup of an individual projects. Whether it is a Gateway backup or Project export, it's always good practice to create backups regularly when making changes to Ignition. project. This page discusses making Gateway backups and restoring from a Gateway backup. To learn more about project backups and restoring projects, refer to the Project Export and Import page. 

Gateway Backup and Restore

Creating Gateway backups and restoring from a Gateway backup are super easy in Ignition. Gateway backups are all inclusive, and typically takes less than a minute to run. It includes everything you find in the Ignition Gateway Webpage. Everything gets backed up - all your projects, Gateway settings, authentication profiles, Tags, database connections, OPC and device connections, alarm pipelines, scripts, sequential function charts, reports, and Image Managment Management Library (i.e., png, jpg, and jpeg files). The only data that is not included in a Gateway backup is data stored in other programs such as SQL databases, PLC programs, other files you manually added to the install directory, and any additional files you may be using. This information needs to be backed up separately.

Perspective custom assets such as fonts, icons, and themes are included in a Gateway backup. In addition, any custom assets in a backup file will be restored when performing a Gateway restore.

You have the option of creating a Gateway backup and restoring a backup from the Gateway Webpage or Gateway Command-line Utility - gwcmd. We recommend using Gateway Webpage since it's much easier.

Scheduled Gateway Backups

In addition to manually taking a gateway backup, an Ignition Gateway can be configured to manually collect gateway backups on a schedule. See the Gateway Settings page for more details.


Scroll html ignore
NameProject Backup vs. Ignition Gateway Backup

Scroll html ignore
NameMaking Ignition Gateway Backups

Manually Collecting a Gateway Backup

The easiest way to create a backup of the Gateway is using the Gateway Webpage

  1. Go to the Config tab of the Gateway Webpage, and click on System > Backup/Restore
  2. The System Backup/Restore page will be displayed. Make sure the Backup tab is selected, then click Download Backup.

  3. By default, this downloads a .gwbk file extension to your local file system in your Downloads folder. 


    The Gateway Backup default filename will look like GatewayName_Ignition-backup-YYYYMMDD-HHMM.gwbk where YYYYMMDD-HHMM is the timestamp of when it was created.

Command-line Utility

In Windows and Linux, you can use the command-line utility to create a Gateway backup. To run the Command-line Utility, open a shell and enter the command below. 


If you want to add a timestamp, you need to enter the date and time in the filename. Refer to the Command-line Utility page for a complete list of 'gwcmd' options.

Code Block
gwcmd -b C:\Backups\Ignition\IgnitionBackup.gwbk

Gateway Restore

Restoring a Gateway backup is just as easy as backing it up and can also be done from the Gateway Webpage.


When you perform a Gateway Restore, ALL of the server's current configuration will be permanently lost! Restoring a Gateway backup overwrites all of the existing settings including your projects. There is no merge option for a Gateway backup. We recommend you always make a backup of the existing server immediately before performing a Gateway Restore.

Scroll html ignore
NameRestoring Ignition Gateway Backups

  1. Go to the Config tab and click on System > Backup/Restore.

  2. The System Backup/Restore screen will be displayed. Click on the Restore tab. Read carefully through the restoration settings, and check the ones you wish to enable. 

    TitleRestore Disabled Checkbox

    If you check the Restore Disabled box, all projects, project resources, notifications, alarm journals, database connections, OPC connections, devices, scripts and third party modules will be disabled upon restart.

  3. Click Choose File, then navigate to your Gateway backup file (*.gwbk). By default, all your Gateway backup files are saved in your Downloads folder unless you select another folder location to choose an exisiting Gateway Backup file (*.gwbk) to restore. 

  4. Choose your Ignition backup file (.gwbk), and click Open
  5. Click Restore at the bottom of the System Backup/Restore screen. The Gateway stops while restoring the backup file. When restoring is complete, the Gateway restarts itself to apply the restored settings. The Gateway Webpage is refreshed and your projects are loaded and your whole Gateway is restored in less than a minute.

Command-line Utility

In Windows and Linux, you can use the command-line utility to restore a Gateway backup. To run the Command-line Utility, open a shell and enter the command below. Refer to the Command-line Utility page for a complete list of 'gwcmd' options.

Code Block
gwcmd -s C:\Backups\Ignition\IgnitionBackup.gwbk