You're currently browsing the Ignition 8.0 docs. Click here to view the latest docs.

Gateway Configuration

Once you have the Gateway up and running, you start by configuring some or all of the general services in Ignition. You make the configuration changes from the Config section of the Gateway Webpage. The different broad categories of what you can configure are as follows:

  • System  (Overview, Backup/Restore, Licensing, Modules, Projects, Redundancy and Gateway Settings)
  • Networking (Web Server, Gateway Network and Email Settings)
  • Security (Auditing ,Users, Roles, Service Security, Identity Providers, Security Levels, and Security Zones)
  • Databases (Connections, Drivers, and Store and Forward)
  • Alarming (General, Journal, Notification, On-Call Rosters, and Schedules)
  • Tags (History and Realtime)
  • OPC Client (OPC Connections and OPC Quick Client)
  • OPC UA (Device Connections, Security, and Server Settings)
  • Enterprise Administration (Event Thresholds, Controller Settings, Agent Management, License Management, and Agent Tasks)
  • Sequential Function Charts (Settings)

Depending on what modules you have installed, some categories may be missing.

Important Gateway Settings

The Gateway is at the heart of the Ignition software. It runs as a web server and you can access it through a web browser. Once running, you can get various status information about the Gateway and access important functions. You can customize the Gateway's Homepage to fit your needs.  Here's a description of all the settings and list of all the their associated properties that you will need to setup based on your Gateway configuration and preferences. 

On this page ...

Required Roles

There are several properties that are required to access certain sections of the Gateway.  

Gateway Config Role(s)Allows you to enter roles to control access to the Gateway Config section.
Status Page Role(s)Allows you to enter roles to control access to the Gateway Status section.
Home Page Role(s)Allows you to enter roles to control access to the Gateway Home section.
Designer Role(s)Allows you to enter roles to control access to the Designer.

Local Client Fallback Settings

Ignition provides a Local Vision Client Fallback mechanism that lets you use a Gateway running on the local machine. If the Gateway is lost, the Client can automatically retarget to a project that you specify in the local in the local Gateway. 

Scheduled Backups

The Scheduled Backup Settings control the Gateway's scheduled backup system. This system is capable of automatically making a Gateway backup and storing it to a folder path, which can be a network path. 

When you enable this system, you must specify a destination folder. This can be a local folder, for example C:\backups or /var/backups , or a network path such as \\fileserver\backups.

The scheduled backup system works on a schedule that is specified using UNIX Crontab syntax. This is a standard format for specifying a basic schedule. The format consists of five space-separated fields, one for minute, hour, day-of-month, month, and day-of-week. The special Gateway Configuration 72 character * means all. Slashes can be used to indicate that values should be stepped, for example, */5 in the minutes field means "every 5 minutes", or 0:00, 0;05, 0:10, etc.

To learn more on how to schedule Gateway Backups, refer the page on Gateway Scheduled Backups

Gateway Audit Profile

The auditing system in Ignition records actions originating from the Gateway, Perspective and Vision projects. For a list of actions that are logged by the auditing system, see Auditing Actions Reference.

Gateway Scripting Project

The Gateway Scripting Project is a Project in which Gateway-scoped scripts with no project affiliation can access user script libraries.

Error Reporting Settings

When an error occurs in the Client or Designer, the users can click a link on the Details tab to report the error via email.

These settings define how the errors are reported.

Multicast Settings

These properties allow the Gateway to broadcast information about itself via multicast UDP packets. This allows the Gateway to be discoverable by any components that are also listening to the same multicast address. For example, native client launchers listen on a multicast address to provide a list of available Gateways on the network. Verify that the send ports and receive ports are open on the Gateway machine in order to be able to broadcast multicast message.


Locking the Gateway

Gateway Property Reference

After you launch the Gateway, you can define the high-level settings that apply to the entire Gateway by going to the Config > Gateway Settings on the Gateway Webpage. From this page, you can use the default values or define a new setting.

Gateway Settings

System Name

Is a unique name for this Ignition installation. It is used to distinguish this server from others on the network when working with multiple Ignition installations.

Caution: It is not recommended to change the System Name on a Gateway that is in production. Doing so can cause subsystems that reference the name, such as the Tag Historian system, to malfunction.

System User Source

Is the user source used to secure access to the Gateway, as well as to the Designer.

Gateway Config Role(s)

Is a comma-separated list of roles, one of which is required to log into the Gateway's configuration section. These roles must be defined in the System User Source.

Status Page Role(s)

The required roles to access the Gateway's Status section. Leave blank to remove security restrictions for this section.

Home Page Role(s)

The required roles to access the Gateway's Home section. Leave blank to remove security restrictions for this section. Note that this is only used to limit the access to the homepage itself, each project has its own user source for limiting access to the runtimes.

Designer Role(s)

Users must belong to one of these roles in order to have access for logging into the Designer. Multiple roles can be specified by separating them with commas.

Create Project Role(s)Users must belong to one of these roles in order to create a new Designer project. Multiple roles can be specified by separating them with commas.
Allow User Admin

Allows the administration of the Gateway's system user source from the Designer and Client. Unless this is enabled, anything outside of the Gateway Configure page is prevented from altering the Gateway's system user source.

Allow Designer SSOAllows single-sign-on authentication for logging into the Designer if the Gateway user source supports it.

Persist Alarms

Whether or not alarm properties such as acknowledgment should persist across Gateway restarts.

Homepage Redirect URLThe URL this gateway will redirect to when http://ip:port/ is visited. Can either be a relative path (e.g., /web/home), or fully qualified (e.g.,


  This feature was removed from Ignition in version 8.0.3

As of version 8.0.3 this setting has been moved to the Networking > Web Server page.

Forces the clients to use SSL encrypted communication when talking to the Gateway. It is highly recommended that you purchase and install a genuine SSL certificate if you use this option. See Installing a Genuine SSL Certificate.

Gateway Scripting Project

The name of the Project in which Gateway-scoped scripts with no project affiliation can access user script libraries.

Gateway Audit Profile

The following feature is new in Ignition version 8.0.8
Click here to check out the other new features

The name of the audit profile that Gateway-scoped actions will log to. See Auditing Actions Reference.

Launch Settings

Designer Memory

The maximum amount of memory that the Designer has access to.

Disable Direct3D

Disables the Direct3D rendering pipeline launched clients. Direct3D can cause performance problems with XOR painting. (affects clients on Windows only)

Disable DirectDraw

Disables the DirectDraw system for launched clients. Can be useful for some video cards that don't support DirectDraw well. (affects clients on Windows only)

Local Vision Client Fallback

Enable Local Fallback

Enables a client to fall back to a project in a local Gateway if communication is lost to the central Gateway. Note that port 6501 must be open on the local machine.

Seconds Before Failover

The number of seconds to wait before switching to the local Gateway project after communication loss.

Fallback Project

The local project to use during fallback.

Scheduled Backup Settings

Enable Scheduled Backups

Enables the scheduled backup system which automatically makes backups at a scheduled time.

Backup Folder

A path to a folder in which to put the scheduled backups.

Backup Schedule

A UNIX 'crontab' format scheduling string representing when to make the backups.

Retention Count

The number of backups to keep in the backup folder.

Error Reporting

SMTP Server

When not blank, user-reported errors are emailed using this SMTP server.

To Address

The email address(es) that will receive the error notification. Separate multiple email addresses with a semicolon (;)

From Address

The email address that the error notification is from.

SMTP Username

A username for the SMTP server, if required.

Change Password?

Check this box to change the existing password.


A password for the SMTP server, if required.


Re-type password for verification.

Multicast Settings

Enable Multicast

Allows this Gateway to be discoverable on your local network.

Multicast IP Address

Gateway messages are broadcast on this address.

Send Port

This port must be open on this machine to send multicast messages.

Receive Port

This port must be open on any machine that will receive multicast messages.

Message Interval

The interval in milliseconds at which multicast messages will be sent.

  • No labels