Gravio HubKit Web UI Guide

Gravio HubKit Web UI is a web-based management interface for configuring and managing Gravio HubKit through a web browser. It is primarily used to manage Gravio HubKit running on Linux devices such as Gravio Hub X64.

Table of Contents

• 1. Overview
• 2. How to Access
• 3. Login
• 4. Navigation
• 5. Screen Components
• 5.1 Hub Management (Statistics)
  • 5.1.1 Feature Package Management
  • 5.1.2 Device Integration Settings (i-PRO / Webhook / MQTT Broker)
• 5.2 Triggers
• 5.3 Inference Models
• 5.4 Charts (Statistics)
• 5.5 Account Management
• 5.6 Calendars
• 5.7 Base Property Profiles
• 5.8 Gravio Hub Settings
• 5.9 MQTT Broker Management
• 5.10 Maintenance

1. Overview

Gravio HubKit Web UI provides the following features:

• System Monitoring: Real-time monitoring of CPU, memory, and disk usage
• Device Management: Registration and configuration of sensor devices
• Trigger Management: Configuration of event triggers and timer triggers
• Inference Model Management: Deployment and management of AI models
• Data Visualization: Chart display of sensor data
• System Settings: Network, time, security, and other settings

2. How to Access

You can access Gravio HubKit Web UI at the following URL:

https://<hostname>.local/login

Or, if specifying the IP address directly:

https://<IP-address>/login

Note: When accessing for the first time, you may see a warning about a self-signed certificate. Follow your browser's instructions to allow the connection.

Initial Setup Access (Gravio Hub X64 WiFi AP Mode)

When setting up Gravio Hub X64 for the first time in an environment without wired LAN, connect to the WiFi access point created by Gravio Hub X64 to perform setup.

1. Power on Gravio Hub X64 (do not connect wired LAN)
2. Connect to "GravioHubXXXXXXXXXX" from your PC's WiFi settings (Password: graviohub)
3. Access https://192.168.100.1 in your browser
4. Log in with local account (gravio / graviohub)

First thing to do after initial setup: After logging in, go to "Gravio Hub Settings" → "Network" to configure WiFi settings and connect to the internet. This enables license acquisition and software updates.

For detailed instructions, see the Gravio HubKit Installation and Upgrade Guide.

3. Login

Login Screen

When you access the Web UI, the login screen is displayed.

Default Account

In the initial state, you can log in with the following account:

Local Account

• Username: gravio
• Password: graviohub

Important: For security reasons, it is strongly recommended to change the password after the first login.

Gravio.com Account

You can also log in with your Gravio.com registered account.

Language Settings

You can switch the language on the login screen: - 日本語 (Japanese) - English

4. Navigation

After logging in, a navigation bar is displayed at the top of the screen. You can access the following menus:

You can log out from the user icon in the upper right corner.

5. Screen Components

5.1 Hub Management (Statistics)

The Hub Management screen allows you to check the current HubKit status and manage devices and sensors.

Displayed Information

CPU Usage

• Kernel: CPU usage by the system
• User: CPU usage by applications

Memory Usage

• Used: Currently used memory (GB)
• Available: Free memory (GB)

Disk Usage

• Display of total capacity and usage
• Usage by data category:
• Media Data: Media files such as images and videos
• Log Files: System logs
• Sensor Data: Data collected from sensors
• Retention period settings for each category

Action Configuration

• Number of configured actions
• Icon buttons open the Feature Package list (Available in Gravio 6.3.0 and later) and Create Feature Package (Available in Gravio 6.3.0 and later) dialogs

Data Records

• Number of records stored in the SQLite database

Device List

Displays a list of registered devices: - Type: Device type - Physical Device: Device name - Device ID: Unique identifier - Area/Layer: Associated area and layer

A button bar above the device list (Available in Gravio 6.3.0 and later) opens the following configuration dialogs. See 5.1.2 Device Integration Settings for details.

• i-PRO: i-PRO camera integration
• Webhook: Webhook endpoints
• MQTT Broker: MQTT subscribe topics
• Edit Device: Edit existing device settings

Sensor Management

Manage sensors in an area and layer structure:

Area Management

• Add Area: Create a new area
• Edit/delete areas

Layer Management

• Add Layer: Create a new layer
• Edit/delete layers
• Sensor type (Kind) settings

Device Binding

• Bind Device: Associate a physical device with a layer
• Enable/disable logical devices
• Unbind devices

Controller Mode and Managed Mode

HubKit can operate in the following modes:

• Controller: Main Hub that manages other Hubs
• Managed: Hub managed by a controller
• Unmanaged: Hub operating independently

To set up as a managed Hub, specify the controller from the Set Management button.

MQTT Broker

The MQTT broker status display and operation buttons are located at the bottom of the Hub Management screen. For details on the MQTT broker feature, see 5.9 MQTT Broker Management.

5.1.1 Feature Package Management

Available in Gravio 6.3.0 and later

A feature package bundles multiple triggers, actions, and related resources into a single .zip file so they can be distributed to and applied on other HubKit installations. Use the icon buttons in the "Action Configuration" section of the Hub Management screen.

Creating a Feature Package

Click the Create Feature Package icon to open the creation dialog.

1. Enter a Package Name (alphanumeric recommended)
2. Use the checkboxes to select the Triggers and Actions to include
3. Optionally toggle Exclude Base Property field values
4. When enabled, sensitive values such as credentials are stripped from the resulting package
5. Click Create to save the package on the HubKit

Feature Package List

Click the Open Feature Package List icon to view packages stored on the HubKit. Each row provides the following actions:

Importing a Feature Package

Use the Import Feature Package button at the top of the list to upload a local .zip file.

• Only the .zip extension is accepted
• If a package with the same name already exists, an overwrite confirmation dialog is shown

Sorting and Search

The list can be sorted by File Name / Modified Date / Creation Date. The search box at the top of the list filters packages by name.

Note: We recommend storing sensitive data (tokens, usernames, third-party passwords, etc.) in Base Property Profiles. By excluding base property values during package creation, you can prevent that information from leaving the HubKit.

5.1.2 Device Integration Settings (i-PRO / Webhook / MQTT Broker)

Available in Gravio 6.3.0 and later

The i-PRO, Webhook, and MQTT Broker buttons above the device list open dialogs for configuring external device integrations.

i-PRO Camera Configuration

Use this dialog to integrate i-PRO series cameras.

1. Click the i-PRO button to open the camera list dialog
2. Click + Add Camera and enter a Name and MAC Address
3. Register the HubKit endpoint URLs displayed at the bottom on the i-PRO camera side (use the copy icon to copy them to the clipboard)
4. Use the edit / remove icons on each row to update or delete existing cameras

For the end-to-end i-PRO integration workflow, see Gravio HubKit External Integration Guide §3.

Webhook Endpoint Configuration

Manage webhook endpoints that receive HTTP requests from external systems.

1. Click the Webhook button to open the webhook list dialog
2. Click + Add Endpoint to create a new webhook
3. Name: Identification name for the webhook
4. Custom Path: Path string after /webhook/urls/
5. Payload Format: query-params (GET) or json (POST)
6. Authentication Type: None or BASIC (username 4+ characters, password 8+ characters)
7. Copy the Webhook URL shown at the bottom of the dialog and register it on the external system
8. Use the edit / remove icons on each row to update or delete existing endpoints

For webhook specifications and usage examples, see Gravio HubKit External Integration Guide §1.

MQTT Broker (Subscribe Topic) Configuration

Configure the topics that HubKit subscribes to from an external MQTT broker.

1. Click the MQTT Broker button to open the topic entry list dialog
2. Click + Add Topic to create a new entry
3. Name: Identification name for the topic entry
4. Broker: Select a registered broker via the "Broker list" link (you can add a new one from the same dialog)
5. Topic: MQTT topic to subscribe to
6. Timeout, ClientID, QoS (0/1/2), Clean Session
7. Use the edit / remove icons on each row to update or delete existing entries

For the end-to-end MQTT integration workflow, see Gravio HubKit External Integration Guide §2.

5.2 Triggers

The Triggers screen allows you to manage event triggers and timer triggers.

Event Triggers

Triggers that execute actions in response to sensor events.

Create from the Add Event Trigger button: - Trigger Name: Identification name - Area/Layer: Monitoring target - Condition: Trigger firing condition - Action: Action to execute - Calendar: Business calendar to reference

Timer Triggers

Triggers that execute actions according to a schedule.

Create from the Add Timer Trigger button: - Trigger Name: Identification name - Schedule: Execution timing (time, day of week, etc.) - Action: Action to execute - Calendar: Business calendar to reference

Trigger Operations

• Enable/Disable: Toggle trigger on/off with the switch
• Edit: Edit trigger with the pencil icon
• Delete: Delete trigger with the trash icon
• Duplicate: Duplicate the selected trigger

Tag Classification

You can classify triggers by setting sub-tags. Filtering by tags is possible in the search box.

5.3 Inference Models

Manage AI inference models.

Supported Model Formats

• TensorFlow: Object detection model
• TensorFlow Lite: Lightweight object detection model
• TensorFlow Lite (Classification): Image classification model

Creating Models

Select from the Create Model dropdown: 1. Enter model name 2. Configure required settings 3. Execute creation

Uploading Models

You can upload pre-created model files from the Upload ZIP button.

Model Management

5.4 Charts (Statistics)

Display sensor data in real-time charts.

Chart Types

• Line Chart: Time series data trends
• Bar Chart: Value comparison
• Pie Chart: Composition ratio display
• Temperature: Temperature sensor dedicated display
• Humidity: Humidity sensor dedicated display
• Pressure: Pressure sensor dedicated display
• CO2: CO2 concentration sensor dedicated display
• Door: Open/close sensor dedicated display

Creating Charts

Click the + button (add icon): 1. Select chart type 2. Select area/layer 3. Configure display options 4. Execute creation

Chart Operations

Kiosk Mode

You can start kiosk mode from the settings icon. Display pinned charts in full screen like a digital signage.

Display modes: - Slide: Display charts sequentially - Grid: Display multiple charts simultaneously

Background image and logo customization is also available.

5.5 Account Management

Manage user accounts and API tokens.

User List

Display a list of registered users: - Account Name: Name used for login - Name: User's name - Role: User's permission level

User Roles

User Management

• Add button: Create a new user
• Edit icon: Edit user information
• Delete icon: Delete user

Note: The gravio account cannot be deleted.

API Tokens

You can issue API tokens for integration with external systems.

1. Click the Create Token button
2. Set token name and expiration
3. Securely store the created token

Note: Tokens are only displayed at creation time. If lost, reissuance is required.

5.6 Calendars

Manage business calendars and control trigger operation days.

Calendar Uses

• Execute triggers only on business days
• Stop triggers on holidays
• Enable operation only during specific periods

Creating Calendars

1. Create a new calendar
2. Set valid/invalid dates
3. Reference calendar from triggers

5.7 Base Property Profiles

Available in Gravio 6.3.0 and later

Base Property Profiles bundle reusable settings such as credentials, connection endpoints, and API keys. Action components reference these profiles, allowing you to manage sensitive information in a single place.

Screen Layout

Click Base Property Profiles in the navigation bar to display the list of registered profiles.

Each row provides Edit and Remove icons. Use the Add button at the top to create a new profile.

Adding / Editing a Profile

Clicking Add or an Edit icon opens the form dialog.

1. Enter a Profile Name
2. Select a Category (the form fields adjust dynamically based on the category)
3. Fill in the category-specific fields (URL, port, username, password, certificate, token, etc.)
4. For OAuth2-based categories an Obtain Token button appears. Clicking it starts the OAuth2 authorization flow in your browser and saves the token automatically after the callback returns to the app
5. Click Save to register the profile

Removing a Profile

Clicking the remove icon opens a confirmation dialog. Removing a profile may break any actions that reference it; check the references before deletion.

Integration with Feature Packages

To protect sensitive information, we recommend storing tokens, passwords, and API keys in Base Property Profiles rather than embedding them directly in actions. When creating a feature package, enable Exclude Base Property field values to keep these values out of the exported package.

5.8 Gravio Hub Settings

Note: This tab is only available on Gravio Hub X64 devices.

Configure Gravio Hub device settings.

Timezone Settings

• Select from available timezones
• NTP synchronization or manual setting

NTP Synchronization: - Specify NTP server for automatic synchronization - Can also operate as a local NTP server

Manual Setting: - Enter date and time directly

Hostname Settings

Change the Gravio Hub hostname.

https://<hostname>.local

becomes accessible.

Note: After changing the hostname, access using the new URL.

Password Change

Change the gravio account password.

Requirements: - 8 to 32 characters - Enter twice for confirmation

Network Settings

Wireless LAN (WiFi)

• SSID selection (detected networks or hidden SSID)
• Password entry
• DHCP or static IP settings

Wired LAN

• DHCP or static IP settings
• IP address, gateway, DNS server settings

SSH Settings

Toggle SSH access on/off.

Note: Exercise caution with security when enabling SSH.

Bluetooth Settings

Toggle Bluetooth on/off.

Sound Settings

Configure notification sounds and sound output.

5.9 MQTT Broker Management

Note: This feature is only available on Linux platforms (such as Gravio Hub X64). Available from Gravio 6.2.1.

Manage MQTT broker (Mosquitto) startup/shutdown and certificate settings.

Overview

The MQTT broker feature allows you to run an MQTT broker on Gravio HubKit. Use this when sending and receiving data via the MQTT protocol from external devices or systems.

Steps to Start MQTT Broker

To start the MQTT broker, you need to complete the following preparation steps:

Step 1: Create MQTT User

1. Navigate to the Accounts screen
2. Click the Add button
3. Enter the following information:
4. Account Name: Username for MQTT clients
5. Password: Password for MQTT clients
6. Role: Select "MQTT"
7. Click the Create button

Step 2: Configure MQTT Certificate

1. Navigate to the Hub Management screen
2. Click the Setting button in the MQTT broker section
3. In the MQTT certificate settings dialog, enter:
4. Common Name (CN): Certificate identification name (required)
   • Example: localhost, 192.168.1.100, mqtt.example.com
5. DNS Names (optional): Comma-separated DNS names
   • Example: mqtt.example.com, mqtt.local
6. IP Addresses (optional): Comma-separated IP addresses
   • Example: 192.168.1.100, 10.0.0.1
7. Click the Save button

Tip: For Common Name, specify the hostname or IP address that MQTT clients will use when connecting.

Step 3: Start MQTT Broker

1. In the MQTT broker section on the Hub Management screen, toggle the switch to ON
2. When the broker starts, "MQTT Broker started" message will be displayed

Connecting from MQTT Clients

To connect to the broker from an MQTT client, use the following settings:

Download Certificate

Clients making TLS connections require the server certificate:

1. Click the Download Certificate button in the MQTT broker section on the Hub Management screen
2. The mqtt-cert.pem file will be downloaded
3. Configure this file as the CA certificate in your MQTT client

Regenerate Certificate

If the server's IP address or hostname changes, you need to regenerate the certificate:

1. Ensure the MQTT broker is stopped (the Setting button is disabled while running)
2. Click the Setting button
3. Enter the new configuration values
4. Click the Save button

Delete Certificate

To delete an unnecessary certificate:

1. Click the Setting button
2. Click the Delete button next to the certificate status
3. Click OK in the confirmation dialog

Stop MQTT Broker

1. In the MQTT broker section on the Hub Management screen, toggle the switch to OFF
2. When the broker stops, "MQTT Broker stopped" message will be displayed

Important Notes

• Be sure to create an MQTT user and certificate before starting the MQTT broker
• Port 8883 (TLS) is accessible externally. Port 1883 is only accessible from localhost
• When MQTT users are added or deleted, the broker configuration is automatically updated
• The certificate is used for MQTT broker TLS encryption and is shared by all MQTT users

5.10 Maintenance

Provides system maintenance functions.

HubKit Information

Display information about the current HubKit: - Version information - License status - System identifier

License Key

Enter/update license key.

Software Updates (Supported Models)

Updates such as Zigbee firmware are available.

Zigbee Receiver Dongle Firmware Update

Zigbee Receiver dongle firmware updates can be performed from the following apps:

• Windows: Update available from Windows Tray app
• Mac: Update available from Toolbar app
• Linux: Only supports updating the legacy Zigbee Receiver (white)

Note: Linux does not support firmware updates for the latest Zigbee Receiver dongle (black). To update the latest Zigbee Receiver dongle (black), please use the Windows or Mac version.

SSL Certificate Settings

Manage certificates for HTTPS communication.

• Use SSL: Enable HTTPS
• Key Pair File: Upload private key file
• Certificate File: Upload certificate file

Proxy Settings

Configure HTTPS proxy and HTTP proxy settings.

• Proxy URL
• Authentication credentials (if required)

Mail Settings

Configure mail server for alert notifications.

• SMTP server
• Port number
• Authentication credentials
• Sender address

Backup/Restore

Export (Backup)

1. Click Backup button to create backup
2. After completion, click Export button to download

Import (Restore)

1. Select backup file with Choose File
2. Click Import button to restore

Note: System restart may be required after restore.

Support Log Export

Export log files for troubleshooting.

1. Click Export button
2. Log file is downloaded

Power Management (Supported Models)

• Shutdown: Power off Gravio Hub
• Reboot: Restart Gravio Hub
• Reset to Initial: Reset to factory settings

Warning: Reset will delete all data and settings.

Troubleshooting

Cannot Login

1. Check username and password
2. Make sure Caps Lock is off
3. Try clearing browser cache

Page Not Displaying

1. Verify Gravio HubKit is running
2. Check network connection
3. Check firewall settings

Settings Not Saving

1. Verify you are logged in with administrator privileges
2. Verify JavaScript is enabled in the browser

Related Documents

• Gravio HubKit Installation and Upgrade Guide
• Gravio System Basic Guide
• Gravio Hub X64 Initialization Method and Supplementary Information