Skip to content

First Login

This guide walks you through logging into the Intellija Gateway for the first time.

Prerequisites

  • Gateway URL from your administrator
  • Network access to the gateway web interface
  • Valid user credentials from your administrator

Accessing the Web Interface

Open your web browser and navigate to the gateway URL provided by your administrator: 

https://your-gateway-url.com

Click the "Secure Sign In" button

Login Page login button

You'll be redirected to your login page

Login Page login page

Enter your credentials (username and password)

You'll be redirected back to the gateway dashboard

First Login Experience

Welcome Dashboard

After successful login, you'll see the main dashboard:

Dashboard First View

  • Logout: End your session securely

Dashboard Navigator root dashboard view

The dashboard shows:

  • System Status: Overall health indicator
  • Connection Status: MQTT broker and device connections
  • Quick Stats: Device count, tag count, polling status
  • Recent Activity: Latest events and changes

Navigation Sidebar Screenshot placeholder: Left navigation menu with all options

The main navigation menu provides access to:

  • Dashboard: System overview
  • Devices: Manage Modbus devices and tags
  • MQTT: Configure brokers and Sparkplug settings
  • Templates: Device template library
  • Monitoring: Real-time data and statistics
  • Admin: User and system settings (admin only)

Initial Configuration Steps

For a new installation, follow these steps:

Configure MQTT Broker

First, connect to your MQTT broker:

Add MQTT Broker Screenshot placeholder: Quick add MQTT broker dialog

Navigate to: MQTT → Brokers → Add Broker

Enter: - Broker name - Server address and port - Credentials (if required)

See MQTT Brokers Guide for details.

Create Sparkplug Group

Define your Sparkplug namespace:

Navigate to: MQTT → Sparkplug Groups → Add Group

See Sparkplug Groups Guide for details.

Create Edge Node

Define this gateway as an edge node:

Navigate to: MQTT → Edge Nodes → Add Node

See Edge Nodes Guide for details.

Add Your First Device

Connect your first Modbus device:

Navigate to: Devices → Add Device

See Modbus Devices Guide for details.

Configure Tags

Define the data points you want to monitor:

Navigate to: Devices → [Your Device] → Tags → Add Tag

See Tag Configuration Guide for details.

Session Management

Session Duration

Your session will remain active as long as: - You're actively using the interface - Your session hasn't exceeded the maximum duration - Your SSO token is valid

Auto-Logout

You'll be automatically logged out after: - 30 minutes of inactivity (default) - 8 hours maximum session time (default) - SSO token expiration

Tip

Any unsaved changes will be lost on auto-logout. Save your work frequently!

Manual Logout

Always log out when finished:

  • Click your username in the top-right
  • Click "Logout"
  • Confirm logout if prompted

Logout Confirmation Screenshot placeholder: Logout confirmation dialog

Troubleshooting Login Issues

Cannot Access Web Interface

Problem: Browser cannot reach the gateway

Solutions: - Verify gateway is running: systemctl status intellija-gateway - Check network connectivity: ping gateway-ip - Verify firewall rules allow port 3000 - Check browser console for errors (F12)

SSO Redirect Loop

Problem: Redirected between gateway and SSO repeatedly

Solutions: - Clear browser cookies and cache - Check Keycloak/SSO configuration - Verify redirect URLs are correctly configured - Contact your administrator

"Unauthorized" Error

Problem: Login succeeds but shows "Unauthorized"

Solutions: - Your user account may not be assigned to an organization - Your user may lack necessary permissions - Contact your administrator to verify account setup

Session Expires Too Quickly

Problem: Logged out frequently

Solutions: - Check SSO token lifetime settings - Verify system time is synchronized (NTP) - Contact administrator to adjust session timeout

Security Best Practices

  • ✅ Always logout when finished
  • ✅ Never share your credentials
  • ✅ Use strong, unique passwords
  • ✅ Enable MFA if available
  • ✅ Don't save passwords in shared browsers
  • ✅ Report suspicious activity immediately
  • ✅ Access only from trusted networks
  • ✅ Keep your browser updated

Next Steps

Now that you're logged in:

Need Help? Contact your system administrator or see the Troubleshooting section.