Thinknx Server Web Interface

The Thinknx server web interface allows you to manage, configure, and monitor the device through a standard web browser, without using additional software.

Through this interface, it is possible to view server information, modify network settings, manage licenses, configure cloud services, perform updates, and use diagnostic tools.

The available functions may vary depending on the server model, installed firmware version, and active licenses.

To access the web interface, you need to know the IP address of the Thinknx server.

Connect the computer to the same local network as the server and open a web browser.

Enter the IP address of the device in the browser address bar.

Starting from firmware 1.1.10.25, the new web interface is available through HTTPS on port 443.

The previous web interface is also available through HTTP on port 5051.

The IP addresses shown are examples only and must be replaced with the actual IP address of the server.

To access the settings, you must log in using the server credentials.

Once authenticated, the following information is displayed at the top of the page:

• Name of the connected user.
• Date and time of the last login.
• Button to change the password.
• Button to log out.

The web interface is organized through a main menu located at the top of the page.

The main available sections are:

The Home page provides an overview of the device and allows quick access to the main functions.

It is divided into several areas.

The Links section provides direct access to the following functions:

• Upload configuration: opens the page dedicated to project upload and settings management.
• Network & KNX: allows you to configure the network parameters and the connection to the KNX bus.
• Language: allows you to change the language of the web interface.
• Bus Monitor: opens the KNX traffic monitoring tool.

The Maintenance section allows you to perform reboot and shutdown operations.

Three commands are available:

A summary of the main device information is displayed at the bottom of the Home page.

This includes:

• License owner.
• Serial number.
• Server ID.
• MAC address.
• Firmware version.
• Maximum number of clients.

This information may be requested by Thinknx Technical Support to identify the device and verify compatibility with the available functions.

The Config section allows you to upload a new configuration, export the server settings, and perform cleanup and reset operations.

The main available operations are:

• Uploading a new configuration generated using Thinknx Configurator.
• Downloading a backup of the settings.
• Deleting Configurator settings.
• Deleting user settings.
• Restoring factory settings.

This function allows you to upload a new configuration to the server, generated through a dedicated export from the Thinknx Configurator software.

To proceed:

1. Open the project in Thinknx Configurator.
2. Use the dedicated export command to upload the configuration to the server.
3. Save the generated file on the computer.
4. Open the Config section of the web interface.
5. Click Select file and select the previously exported file.
6. Click Upload to start the transfer.
7. Wait for the procedure to complete and check the confirmation message.

The configuration can also be uploaded through the deployment functions of Thinknx Configurator.

The Download button allows you to download a backup of the settings stored on the server.

The file contains information related to the device configuration, such as scenarios, automations, and other settings.

The backup can also be sent to Thinknx Technical Support to allow the settings to be analyzed and to retrieve information that may be useful for troubleshooting.

The Delete Configurator settings command deletes the scenario settings derived from the uploaded project.

This operation causes the server to reboot.

The Delete user settings command deletes settings customized by the user, such as schedules, scenarios, and initial data.

This operation causes the server to reboot.

The Factory reset button deletes all settings and the project stored on the device, returning the server to its factory state.

The operation causes a full reboot of the server.

The Server menu contains the main configuration and administration settings of the device.

The available sections include:

• Status.
• Access Control.
• License & Code.
• Users.
• Network & KNX.
• Updates.
• Date & Time.
• Voice Control.
• ThinknxCloud.
• Integration Kit.
• Memory Status.
• Language.

The following sections describe the main available functions.

The Status section allows you to view information related to the device and its operation.

The displayed information includes:

• License owner.
• Serial number.
• Server ID.
• MAC address.
• Software version.

• Maximum number of supported clients.
• Current number of connected clients.
• Code of the last connected client.
• IP address of the last connected client.
• Time elapsed since server startup.
• Time elapsed since process startup.
• Date and time of the uploaded configuration.

When available, the following information is also displayed:

• Number of registered PBXs.
• VNC connection status.
• Temperature.
• Humidity.
• Brightness.

The Calibrate sensor button allows you to access calibration of the available sensors.

The list of functions enabled on the device is displayed at the bottom of the page.

The available licenses depend on the commercial configuration of the server.

The Access Control section allows you to manage the codes used by the access control functions.

It is possible to:

• View existing codes.
• Create new codes.
• Modify or delete codes.
• Assign a role.
• Configure a validity interval.
• Apply a time schedule.
• Assign additional areas.
• Export codes.

The code table allows you to view the status and properties of each entry.

The License & Code section allows you to manage license codes and clients authorized to connect to the server.

License codes enable the functions available on the Thinknx server.

The page allows you to view installed codes and add new licenses.

To add a license:

1. Request the license code from Thinknx by providing the server identification information.
2. Enter the code in the dedicated field.
3. Click Add license.

Each client authorized to connect is identified by a code.

The section allows you to:

• View registered clients.
• Enable or disable codes.
• Modify the description.
• Manage the available properties.
• Delete codes that are no longer required.
• Add new client codes.

The page also displays the maximum number of enabled clients and information about the last connected client.

The Push Notification section allows you to send a push notification to enabled users.

This function can be used to communicate information to users through the client devices associated with the server.

The Users section allows you to manage users authorized to access and manage the installation.

The Network & KNX section allows you to configure server connectivity and settings related to the KNX bus.

The page is divided into several areas.

The first section displays the network settings currently in use.

These include:

• DHCP client status.
• IP address.
• Subnet Mask.
• Gateway address.
• Primary DNS.
• Secondary DNS.

It is possible to enable DHCP or manually configure the network parameters.

For manual configuration, enter the required values and click Save network changes.

The page allows you to enable or disable the device Wi-Fi interface.

After changing the setting, click Save Wi-Fi network changes.

The first activation may require a full reboot of the device.

The Network Diagnostics section allows you to check the connection status and the reachability of the services required for server operation.

Scroll down to the Network Diagnostics section and click the Check status button.

The page dedicated to checking network connections and services will open.

Click Check network to start the checks.

The diagnostics check the following services:

• Ethernet connection: checks external network resolution, an essential prerequisite for cloud services.
• Thinknx Cloud: checks connectivity to Thinknx Cloud services.
• Remote client connection: checks whether the server can be reached from the Internet through the client port.
• Remote assistance: checks the availability of the service used by Thinknx Technical Support.
• Remote maintenance: checks the connectivity required by the Remote Maintenance service.
• External DNS resolution: checks that the MyThinknx ID points to the server's current public IP address.

At the end of the check, each service is identified by a colored indicator representing its status.

• Green – OK: the service is reachable and working correctly.
• Yellow – Warning: some connectivity issues have been detected. The diagnostics indicate the ports or services that cannot be reached. These issues do not necessarily affect all server functions.
• Red – Error: the required connectivity is unavailable and the affected functions cannot be used.

For more information about checking the connectivity required for Remote Maintenance, see:

Remote Maintenance

This section allows you to configure how the KNX settings are used.

The following options are available:

• Overridden: uses the settings defined directly in the web interface.
• From project: uses the settings provided by the Thinknx Configurator project.

The available settings include the KNX physical address and activation of the KNXnet/IP interface.

After making the required changes, click Save KNX settings changes.

For a complete explanation of KNXnet/IP interface configuration, see:

KNXnet/IP Interface Configuration

The VNC section allows you to enable or disable the device VNC service.

The service allows remote access to the server graphical interface through a VNC client.

The port used is:

5900 TCP

To change the service status:

1. Select Start VNC or Stop VNC.
2. Click Save VNC changes.

The Updates section allows you to check whether new software versions are available for the Thinknx server.

To check for available updates:

1. Open the Updates section.
2. Make sure that the server has a working Internet connection.
3. Click Check updates.
4. Wait for the search to complete.

If compatible updates are available, it will be possible to proceed by following the instructions displayed.

The Date & Time section allows you to configure the server internal clock.

The page displays:

• Current time zone.
• Current time.
• Current date.
• Internet synchronization status.
• Configured NTP server.

Automatic synchronization through an NTP server can be enabled.

To configure it:

1. Enable Internet synchronization.
2. Select the time zone.
3. Enter the NTP server address.
4. Save the changes.

When automatic synchronization is not used, the following values can be entered manually:

• Hour.
• Minutes.
• Day.
• Month.
• Year.

Click Save changes to apply the new values.

The Voice Control section allows you to manage Thinknx server integrations with voice assistants.

The integrations include:

• Apple HomeKit: displays the pairing code and allows pairing and service reset operations to be managed.
• Amazon Alexa: displays the pairing status and allows management of the connected account.
• Google Home: Soon to be available.

For more information about configuring and using voice integrations, see the dedicated guide:

Voice Control

The ThinknxCloud section allows you to manage the server parameters associated with Thinknx cloud services.

The page is divided into three main areas:

• Cloud service configuration and status.
• Thinknx Portal user management.
• Remote Maintenance.

To use ThinknxCloud services, an initial configuration must be performed directly from the server web interface.

Open:

Server → ThinknxCloud

Click the Enable ThinknxCloud button.

During the procedure, you will be asked to enter:

• Installer email address: email address to be associated with the ThinknxCloud service.
• Cloud password: password dedicated to the server, used to upload and manage projects through the Cloud.

Once the configuration is complete, the Cloud service will be enabled and the related management settings will become available.

Once the service has been enabled, the page displays the current settings.

The available information includes:

• Cloud activation status.
• Cloud connection status.
• Associated email address.
• MyThinknx activation status.
• MyThinknx ID.
• Subscription code.
• Subscription expiration date.
• Available services.
• Integration Kit status.
• Used and available storage space.

Several commands are available for managing the service:

This section allows you to associate new Thinknx Portal users with the server and view accounts that are already connected.

To associate a new user:

1. Click Associate a user.
2. Log in to the Thinknx Portal.
3. Complete the association procedure.

Once associated, the user is displayed in the dedicated table.

The page also allows you to view user information and remove existing associations.

The Remote Maintenance function allows the System Integrator to establish a tunnel to the server through the Internet.

The tunnel allows access to the device web interface and allows ETS to be used to perform KNX programming operations remotely.

The page allows you to enable or disable the service and view the current connection status.

The Integration Kit section allows you to manage the service dedicated to integration with external applications and systems.

Through this function, it is possible to use the integration interfaces provided by the Thinknx server.

For API configuration and usage, refer to the dedicated Integration Kit documentation.

The Memory Status section allows you to check the health status of the Thinknx server internal memory.

By clicking Start memory check, the server performs a memory verification procedure.

This function is useful for identifying possible problems related to the internal memory of the device.

The Language section allows you to change the language used by the web interface.

The available languages are:

• English.
• Italiano.
• Deutsch.

Select the required language to change how the pages are displayed.

The Reboot menu provides access to device maintenance operations.

The same commands are available on the Home page.

Restarts the server software without performing a full reboot of the device.

Completely restarts the Thinknx server.

During this operation, the device will temporarily be unreachable.

Starts the server shutdown procedure.

The Monitor menu provides access to the server monitoring tools.

By selecting KNX Bus Monitor, it is possible to view traffic on the KNX bus and interact directly with group addresses.

The monitor is divided into several areas.

The main table displays the detected KNX telegrams.

The displayed information includes:

• Time: time when the telegram was received.
• Sender: physical address of the sending device.
• Destination: destination group address.
• Data: value carried by the telegram.

The monitor periodically updates the displayed telegrams.

A command is also available to clear the messages currently displayed.

The sending section allows you to write or read values on the KNX bus.

The following parameters can be configured:

• Group address.
• Data length.
• Data type.
• Available options.
• Value to send.

The Send and Read buttons respectively allow you to send a telegram or perform a read request.

The KNX Recorder function allows KNX telegram recording to be enabled.

The page displays:

• Recorder status.
• Database size.
• Available space.

Recorded telegrams can be exported in an XML format compatible with ETS.

The available filters allow you to select:

• Time period.
• Destination group address.
• Physical address of the sending device.

After configuring the parameters, click Download log for ETS.

The Log Monitor section, accessible from the Monitor menu, allows you to view logs generated during operation of the Thinknx server.

Through this page, it is possible to view system messages and information related to operations performed by the server.

Logs are a useful tool for checking device behavior and identifying possible anomalies during operation of the installation.

The displayed information may include:

• System messages.
• Information related to service operation.
• Errors or anomalies.
• Diagnostic messages generated during operations.

• Make sure that the server is switched on and correctly powered.
• Make sure that the computer is connected to the correct network.
• Check the IP address being used.
• Check device reachability using ping.
• Make sure that the correct protocol and port are being used.
• Check for any network or firewall restrictions.

• Check the newly configured IP address.
• Make sure that the address belongs to the correct network.
• Check the subnet mask and gateway.
• Reopen the browser using the new address.

• Check the Internet connection.
• Check the gateway and DNS configuration.
• Run the diagnostics in the Network & KNX section.
• Check the connection status on the ThinknxCloud page.

• Check the physical connection to the KNX bus.
• Check the KNX settings in the Network & KNX section.
• Make sure that the KNXnet/IP interface is enabled, if required.
• Check the KNX Bus Monitor to verify bus traffic.

• Make sure that the Internet connection is stable.
• Check the current firmware version.
• Check the hardware compatibility of the device.
• Do not disconnect the power supply during the update.

If anomalies occur during server operation, open:

Monitor → Log Monitor

Check for any error messages or diagnostic information that may help identify the problem.

If the problem persists, contact Thinknx Technical Support and provide the server model, serial number, firmware version, and a description of the reported anomalies.

For additional information about individual functions, see the dedicated guides:

• KNXnet/IP Interface Configuration
• Remote Maintenance
• Voice Control