User Manual







Sepasoft - MES Modules
Cirrus Link - MQTT Modules


Inductive University
Ignition Demo Project
Knowledge Base Articles
IA Support
SDK Documentation
SDK Examples


Ignition 8
Ignition 7.9
Ignition 7.8

Deprecated Pages

Versions Compared


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

Quick Start Guide

Are you new to Ignition? Here are a few simple steps to get going right away! In very little time, you can get a sample project up and running. 

When getting started with Ignition, it helps to have a general idea about the major steps involved in designing your SCADA/HMI projects. Although there are many creative and innovative ways of using Ignition to do almost anything you want, we outlined some simple steps that can guide you in setting up a project.


1. Download and Install Ignition

Installation is simple and can be done in under 3 minutes! Let's get started and install now.


titleInstall Ignition on Windows

titleBefore you install Ignition, make sure you meet the minimum system requirements:
  • Dual-Core Processor (64 bit)
  • 4GB RAM
  • 10GB free HD space

Also, ensure you have Administrator privileges to run the Ignition installer.

To Download and Install Ignition on Windows

  1. Go to the Inductive Automation website at

  2. Select Download Ignition in the upper right corner of the page. The browser will determine what operating system you're running and will bring up Download for Windows. 

  3. Click Download for Windows. If you want to see what other operating systems are supported, click on the Other operating systems and versions link. 

  4. Run the downloaded file Ignition-X.X.X-windows-x64-installer.exe (found on the lower-left of the window if using Chrome), or go to your downloads folder and double-click the file to start installation.

  5. The Setup window welcomes you to the Ignition Setup Wizard. To being the installation, click Next.

  6. The Installation Directory window will be displayed. By default, Ignition is installed under your Program Files folder: Program Files\Inductive Automation\Ignition. This is usually a good choice.
    To accept the default Installation Directory, click Next.

  7. The Installation Mode window will be displayed. Select either the Typical or Custom mode. The Typical installation includes Ignition with most of the most commonly used modules. The Custom installation lets you control and individually select the modules that you want installed. (Both options are shown in this step). If you choose Typical mode, click Next.

    Typical Installation

    If you select Custom mode, check the box for the modules you want to install and uncheck those modules you don't want installed as part of your Custom Ignition installation. To see a brief description of the module, click on the module name. If you choose Custom mode, click Next.

    Custom Installation

  8. The Setup Wizard shows Ignition is now Ready to Install. If you decide to change your selections, click Back to go back and make your changes. Click Next to continue.

  9. Ignition will install the selected modules. When installation is complete, click Next.

  10. After Setup Wizard shows Ignition installation is finished, make sure that the check box for Start Ignition now is selected, then click Finish.

  11. Once Ignition is installed, your default web browser will open and you will be greeted with a Welcome to Ignition message. Click Get Started.

  12. The End User License Agreement (EULA) window will be displayed. Click the button acknowledging you have read and agree with the terms and conditions, then press Next.

  13. An Account Setup window will open for you to enter your first user. This first user will be the main / administrator account with full privileges in Ignition. Enter a username and password, andclick Next.

  14. The HTTP Configuration window will open for you to configure the HTTP and HTTPS Ports. The default HTTP Port is 8088, and the default HTTPS Port is 8043. Click Next to continue.

  15. The Setup Completed window will be displayed, and now you can Start the Gateway.

    A splash screen informs you that Ignition is starting. This may take a few minutes to finish.

  16. That’s it! Ignition Installation is complete and the Gateway is launched. You will then be presented with the following Congratulations window to complete your configuration setup. You can click a link to Setup a Device, Activate a License, Connect to a Database, Edit Gateway Settings, or go to the GatewayHomepage. You can also do theses steps from the Gateway Homepage.

    Your web browser opens the Gateway Homepage at http://localhost:8088. Sign in using the credentials for the administrator or user with full privileges for the Gateway as shown in Step 13 above.


    Ignition installs itself as a Window Service (Start > Control Panel > Administrative Tools > Services > Ignition Gateway), so it starts automatically when your computer starts up.

To learn more, go to Windows - Install!

Or Install on Linux or Mac OS X!


2. Launch the Gateway Webpage

The Ignition Gateway is a web server. When it is running, you access it through a web browser in just two steps.

If you're not already logged into Ignition, enter the credentials for the administrator or user with full privileges for the Gateway. 


titleLaunch the Gateway Webpage
  1. Figure out the IP address of the computer you installed Ignition on. If this computer is the one Ignition is installed on, then you can use localhost instead of the IP.
  2. Open up a web browser and go to this address: http://ipaddress:8088 and it will bring up the Gateway webpage. If you are using localhost, it will look like this: http://localhost:8088.

    The first time you go to the Gateway webpage, it shows you the Designer, Perspective Projects, and Vision Client Launchers.

  3. To navigate back to the Gateway Homepage, click the Home button.


3. Connect to a Device

With the Ignition OPC-UA module and device drivers installed, connecting to a device is simple. 


titleConnect to the Generic Simulator
  1. If you are not already logged into Ignition, enter the credentials for the administrator or user with full privileges for the Gateway, and click Login.
    From the Gateway Webpage, navigate to the Config section.

  2. Scroll down to the OPC-UA Server section on the left and click the Device Connections link.

  3. To add a new Device Connection, click the Create new Device... link.

  4. Select Simulator: Generic and click Next.

  5. Give the new connection a name and click Create New Device.

    A green "success" message will be displayed when the device is created.

Ignition can connect to many different devices natively with the built-in OPC-UA Server.

To learn more, go to the OPC UA and Devices pages!


4. Connect to a Database

After you install your database, you can connect it to Ignition. 


titleConnect to MySQL
  1. If you are already logged into Ignition, then go to the Config section of the Gateway Webpage, otherwise login as the user with full / administrative privileges.

  2. From the Config section, navigate to the Databases > Connections page. 

  3. Click the Create new Database Connection... link.

  4.  Select the MariaDB Connector/J option and click the Next > button. The MariaDB connector will work for many types of MySQL installations. It is recommended to get the official driver, see the JDBC Drivers and Translators page for more information.

  5. Enter a Name, Connect URL, username, and password.
    If you just installed MySQL on the same machine as Ignition and it has a schema called test you will be able to use the following Connect URL:
    Connect URL: jdbc:mysql://localhost:3306/test
    The username and password should have been set when MySQL was installed, but root is often the username for test systems.

    Scroll to the bottom and click the Create new Database Connection button.

    A "success" message will appear when the database connection is created.

To get detailed descriptions for a number of different database connections, see Connecting to Databases. You can also go to Database Connections to learn how databases are used in Ignition and how to get started.


5. Open the Designer

Now that you set up a device (Step 3) and database (Step 4) connections, let's open the Designer and create a project.


titleLaunch the Designer and Create a Project
  1. If you are already logged into Ignition, then go to the Homepage of the Gateway Webpage, otherwise login as the user with full / administrative privileges.

  2. From the Gateway webpage, click the Download button for the Designer. 

  3. Select the Download button for the platform you are running on: Windows, Mac OS, or Lunix. In this example, we are running on Windows.

  4. Run the downloaded file (DesignerLauncherSetup.exe) found on the lower-left of the window, or go to your downloads folder and double-click the file to run it.

  5. The Select Additional Tasks window will open. Here, you can select additional tasks that you would like to setup to perform while installing the DesignerLauncher. It's a good idea to Create a desktop shortcut so it's easily accessible when you want to open the Designer Launcher. Click Next.

  6. Now, you're Ready to Install the Designer Launcher on your computer. Click Install to continue. 

  7. Once the Designer Launcher is installed, complete the setup by checking the box to Launch Designer Launcher and click Finish.

  8. The Ignition Designer Launcher window will open. Here you can select any Designers you have permission to launch. If you are running this for the first time, by default, you will only see one Designer. Click Launch.

    1. You also have the option to Create Shortcut, or Launch + Create a Shortcut on your desktop by clicking the dropdown.

      If you Create a Shortcut, it will look like the image below with the name of your Designer (i.e., Controller) on it like the icon below. Click on the shortcut icon to launch your Designer.

      Since a Designer Launcher icon was created in Step 7, it is aready on your desktop. By clicking the Designer Launcher icon, it will open the Ignition Designer Launcher window and display all your Designers.To learn more, refer to Designer Launcher.

  9. The Designer starts up and the login window is displayed. Enter the credentials for the administrator or user with full privileges for the Designer, and click Login. It should be the same as the login for the Gateway Config section.
    Note: Login credentials are set in the Config section of the Gateway Webpage, under Security > Users, Roles.

  10. The Open/Create Project window is displayed giving you two options, to create a new project or open an existing one.  Since we don't have any existing projects, Let's create a new project by clicking + New Project. 
    Image Removed
    Image Added

  11. In This opens the New Project Setup area complete  screen. Complete the following fields:
    1. In the Project Name field, Project Name - enter a name for your new project. The Project Name can only consist of alphanumeric characters and the '_' (underscore) character. Spaces and other special characters are not supported. 
    2. Project Title (optional) - This is the name that will be displayed on the launch page of the Gateway and in the runtime Client or Session. There are no spaces!).The User Source field restrictions on using special characters or spaces. If you do not specify a title, the project name will be displayed on the Gateway launch page and in the runtime.
    3. User Source - will automatically populate to 'default.'  If you created a Database Connection, you will see the Default Database field is already populated. This Used for granting users access to the project. For more information or to add users, see Security.
    4. Default Database - Select the database from the dropdown list. This will be important when we get to storing history.The Default Tag Provider  Any queries to the database will use this default database connection unless explicitly specified.
    5. Default Tag Provider - Select the primary Tag provider from the dropdown list.  Most installations will likely only have one provider, but in situations where there are more than one, this is the provider that will be used unless explicitly specified. This field will automatically populate to 'default.'
    6. Parent ProjectEach project may have a parent project, and will inherit all of the resources of that parent project. Click the dropdown list to see all the available options.
    7. Project Template - There are several pre-built project templates focused on navigation that support either Perspective or Vision: Perspective Menu Nav, Perspective Web Nav, Vision 2-Tier Tab Nav, Vision Tab Nav, and Vision Tree Nav. Click the dropdown to see all the available options.
    8. Click on Create New Project
      Image Removed
      Image Added

  12. When you open the Designer interface for the first time, the Perspective Page Configuration opens if you have the Perspective Module installed. If you don't have the Perspective Module installed, the Vision Designer window will open. 

    You can begin designing in either Perspective or Vision from the Designer interface, as shown below. Expand the Perspective and Vision folders and you'll notice that the folder contents are dfferent. In Perspective, you add components to Views. In Vision, you add components to Windows. To learn how to add components and bring them to life, go to Quick Start - Perspective Session and Quick Start - Vision Client.

Learn more about the Designer, Perspective Designer Interface, and Vision Designer Interface.


6. Create Tags

With the Designer open, a great first step is to create some Tags. You'll use these Tags for realtime status and control and to store history with the Tag Historian. You can use Drag and Drop to bring Tags into Ignition with the Designer. Once there, Tags are all configured in the Tag Browser panel.


titleClick and Drag Tags into the Designer

If you are connected to a device in Step 3, the easiest way to create some Tags is by dragging the Tags from the OPC Browser.

On the left side of the Designer you will see 3 panels, the Project Browser, the Tag Browser, and the Property Editor.

  1. In the Tag Browser, select the Tags folder then click the Browse OPC Servers icon. The OPC Browser will be displayed and you can browse all of your OPC connections.

  2. By default, you have a connection to the internal Ignition OPC-UA Server. Expand the Devices folder to find your list of devices, and expand your device folder to see some Tags inside. From the OPC Browser, highlight the Tags you want (for example, as in the image below, the entire Sine folder is selected) and drag it to the Tags folder in the Tag Browser. You can drag individual Tags or whole folders. When you drag folders, Ignition keeps the same hierarchy as the PLC.

  3. That's it! You now have some Tags. Expand the Tags folder and the new Sine folder to see what was added. You can see their values come in and start updating automatically. By default, they update at a 1 second rate.

Learn more about Tags!


7. Add History to Tags

Storing history for your Tags is simple, and once that's done we can display it on screen in a variety of ways. If you are connected to a database in Step 4, you are ready to add history to some of our Sine Tags.


titleAdd History to your Tags
  1. In the Designer, go to the Tag Browser and select one or more Tags.
    For example, select all the Sine Tags in the Sine folder by holding the Ctrl key and clicking on several Tags.

  2. Right-click on the selected Tags, and then select Edit tag(s).
    The Tag Editor window is displayed. Here, you can edit the Tag and change the name, data type, scaling options, metadata, permissions, history, and alarming.

  3. Scroll down to History on the left side of Tag Editor, and set History Enabled to 'true'.

  4. Choose a database from the Storage Provider dropdown, like the one we set up earlier.

  5. To set the rate that data is logged:
    1. Change the Sample Mode to Periodic.
    2. Set the Sample Rate to 1. (Data will be logged every 1 second).
    3. Verify that the Sample Rate Units is set to Seconds (which is the default).

  6. Click OK.

  7. Now look in the Tag Browser, to the right of each Sine Tag that is storing history, an icon () appears letting you know it is setup.

    If you were to look in your database, you can see all the tables and data Ignition created for you.

Learn more about Tag Historian!

8. Adding Components

Building your industrial application starts by adding components. Whether you're using the Perspective Module or the Vision Module, adding components is easy, but they each have their own visualization system. It's for this reason, the Quick Start Guide dedicated separate Perspective and Vision pages for how to add components and configure live values. Click the link below to navigate to the respective module's page. 

When you open the Designer interface for the first time, the Perspective Page Configuration opens assuming you have the Perspective Module installed, as shown in the Perspective Session image below. If you don't have the Perspective Module installed, the Vision Designer window will open.