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.

AI Client Integration (MCP)

Available from Gravio 6.4.0

Shows the configuration for connecting AI clients such as Claude Desktop and Cursor to the HubKit MCP Server. Open it with the Show MCP Setup button in AI Client Integration (MCP) under the current login account information. The screen shown right after you create a Personal Access Token also has Set up Claude Desktop, Set up Cursor and Other MCP Clients buttons.

• When opened right after you create a token, the configuration is shown with that token filled in. Keep the token with the Copy Token or Save Token to File button. It cannot be displayed again after the dialog is closed
• When opened with Show MCP Setup, replace YOUR_TOKEN in the configuration with a Personal Access Token you created
• The endpoint URL shown in the configuration (http://<hub address>:29454/mcp) can only be reached from the hub itself. To connect from an AI client on another PC, for example to a Linux or Gravio Hub X64 hub, connect to https://<hub address>/mcp instead. See the HubKit MCP Server Guide for examples
• If an admin has turned the MCP server off on a Gravio Hub X64, this is shown, and AI clients cannot connect until an admin turns it on in Network Access or MCP Server in Gravio Hub Settings

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

For signal strength and speed guidelines when installing Gravio Hub X64 over Wi-Fi, see Wi-Fi Signal Strength and Speed Guidelines.

Wired LAN

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

Wi-Fi AP Mode

Gravio 6.3.2 and later: AP mode (hotspot) can now be started/stopped from the Web UI.

• Turning AP mode on makes the Gravio Hub broadcast its own Wi-Fi access point, allowing direct connections from an iPhone or PC (mainly for initial setup)
• If the Hub is connected as a Wi-Fi client when AP mode is turned on, that connection will be disconnected
• While in AP mode, entering the SSID and password of the Wi-Fi network you want to join and pressing "Set" automatically stops AP mode, connects to the specified Wi-Fi, and restarts the Hub
• When AP mode is combined with LTE WAN, the WAN Port Forwarding feature lets LAN clients in AP mode reach the internet via LTE, publish LAN services, and block specific ports
• From Gravio 6.4.0, a warning is shown for a rule that exposes the unauthenticated Hub API (port 29442) to the WAN, or port 443 while the hub lets its API be used without logging in
• When AP mode is not running but is still turned on (it starts when the Hub restarts), this is shown. If you do not use it, press Stop AP mode (Gravio 6.4.0 and later)
• When AP mode started as a fallback because there was no wired LAN or Wi-Fi uplink, the Hub retries the uplink at the next startup (Gravio 6.4.0 and later)

WAN (LTE) Settings

Gravio 6.3.2 and later: WAN connection via LTE USB dongles is now supported.

• Supported dongles: SPEEDWAY PLUS SWD01 and Soracom Onyx (SC-QGLC4-C1)
• Enabling "Use WAN (LTE)" connects to the internet via LTE (changing this setting requires a restart)
• APN, username, and password can be configured (Soracom SIMs work with the default values)
• Wi-Fi can be used as the preferred uplink with LTE as fallback, and the connection status (Connected / No APN / Checking SIM, etc.) is shown in the Web UI

SSH Settings

Toggle SSH access on/off.

Note: Exercise caution with security when enabling SSH.

Network Access

Available from Gravio 6.4.0: Shown to admins only. Requires an OS image with the host firewall. A Gravio Hub X64 with the old disk layout can be moved to it with OS Update.

Choose which services other machines on the network can reach. Each service shows its ports, whether it is listening, the firewall state (Allowed / Blocked) and the setting. Closed ports stay closed across reboots and updates.

Listening now, below the table, shows the ports and addresses the Hub listens on, the service, and whether other machines can reach them.

Note: If "The host firewall is installed but not loaded" is shown, other machines can reach every port the hub listens on, and ports cannot be closed here. Restart the hub.

MCP Server

Available from Gravio 6.4.0: Shown to admins only, in place of Network Access, on an OS image without the host firewall.

Enable the MCP server turns the HubKit MCP Server on or off. It is on by default.

Tailscale Remote Access

Gravio 6.3.2 and later: Available only on Gravio Hub X64.

Remote access via Tailscale can be turned on/off on demand from the Web UI. The connection persists across restarts.

• Connect: Enter an auth key (tskey-auth-...) issued from your tailnet admin console and click "Connect" to start Tailscale and join the tailnet. While connected, this device can be accessed remotely via the tailnet
• Status display: Shows the connection status, Tailscale IP, and device name
• Disconnect behavior (choose one of two modes):
• Logout (recommended, default): Logs out of the tailnet and discards this device's tailnet registration. A new auth key is required to reconnect. Ephemeral keys are recommended
• Stop while keeping registration: The device stops while remaining registered in the tailnet and can reconnect without an auth key. Use a regular (expiring) key in this mode (ephemeral keys cannot be used because the node is removed from the tailnet while stopped)

Bluetooth Settings

Toggle Bluetooth on/off.

Sound Settings

Configure notification sounds and sound output.

OS Update (Disk Layout Migration)

Available from Gravio 6.4.0: Shown on a Gravio Hub X64 with the old disk layout.

Moves the Hub to the layout of the current OS image, with a recovery partition and the host firewall, without a USB stick. It downloads the new OS, makes room on the disk and installs the new OS. The Hub ID, the Hub settings and the network settings are kept.

Steps:

1. Check: Shows the new OS image, the size of the Hub data, and whether the update can start on this Hub. When the system disk does not have enough free space, the places that take the most space are shown (the update deletes nothing by itself). Free up space, then press Check again
2. Download the new OS: Press Download to download the new OS image. The Hub keeps running during the download. If the download is interrupted, for example by a restart, it resumes where it stopped
3. PC backup: Press Create backup, then Download to this PC, to save a backup of the Hub data on this PC. After saving it, select the check box confirming that you saved it. The PC backup is recommended when the Hub data is 4 GB or less (you can also choose Start without a PC backup), and required when it is larger
4. Before you start: Check the ports the firewall allows after the update, and the notes
5. Start the update: Press Start the update. The Hub restarts twice and is unavailable for usually 5 to 15 minutes (up to about 30 minutes with a lot of Hub data). The page reconnects by itself and shows the progress and the result

Notes:

• Do not turn off the power or unplug the Hub until the update has finished. A UPS is recommended
• When the Hub data is larger than 4 GB, logs, camera images and videos, sensor data history, AI models and files saved by Actions are not carried over. After the update, restore the PC backup you saved in Gravio Configuration > HubKit Data Import (the Hub ID is restored with it)
• After the update, other machines can reach only the ports the firewall allows (the MQTT broker's 8883 and 8083 stay reachable). After the update, Network Access shows and switches each service
• If the update stops partway, you can Continue it, or Cancel the update to return the Hub to how it was. The downloaded image is kept when you cancel

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
• Certificate Method (Gravio 6.3.2 and later): Choose between "Upload certificate manually" and "Obtain automatically with Let's Encrypt"

Upload certificate manually:

• Key Pair File: Upload private key file
• Certificate File: Upload certificate file

Obtain automatically with Let's Encrypt (Gravio 6.3.2 and later):

• Enter the domain name (FQDN) and an optional email address (for expiry notifications), then click Obtain Certificate to automatically obtain a server certificate from Let's Encrypt
• After obtaining, the certificate expiry date is displayed and the certificate is renewed automatically as the expiry approaches
• Prerequisites: The domain's DNS record must point to this Hub, and port 80 must be reachable from the internet

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