Beijer ELECTRONICS CloudVPN Agent Software User Guide

Beijer ELECTRONICS CloudVPN Agent Software

 

Función y área de uso

This document describes how to install and activate the CloudVPN Agent on X3 web HMIs (pro, marine, and extreme) in a Docker environment.

CloudVPN, available as both hardware and software, enables secure communication over untrusted networks. It encrypts data using AES-256.

CloudVPN works as a virtual network extension. It allows you to access remote devices as if they were directly connected to your local network.

Acerca de esta guía de inicio rápido

This Quick Start Guide provides basic instructions for installation and activation. It does not replace the full product documentation.

Alcance

This document uses the following hardware and software:

• X3 web (pro, marine, extreme)
• CloudVPN Agent (BAPP)

Recursos adicionales

Para obtener más información, consulte:

• Help Online
• Portal de documentación
• Connected Forum

Comentario

Send feedback about this document to:

support.europe@beijerelectronics.com

Copyright © 2026 Beijer Electronics AB. Reservados todos los derechos.

La información de este documento está sujeta a cambios sin previo aviso y se proporciona según su disponibilidad en el momento de su publicación. Beijer Electronics AB se reserva el derecho a modificar cualquier información sin actualizar esta publicación. Beijer Electronics AB no asume ninguna responsabilidad por los errores que puedan aparecer en este documento. Todos los exampLos términos de este documento solo tienen como objetivo mejorar la comprensión de la funcionalidad y el manejo del software. Beijer Electronics AB no asume ninguna responsabilidad si estos términos...ampLos archivos se utilizan en aplicaciones reales.

Given the software’s wide range of applications, users must acquire sufficient knowledge to ensure it is used correctly in their specific application. Persons responsible for the application and the equipment must themselves ensure that each application is in compliance with all relevant requirements, standards, and legislation in respect to configuration and safety. Beijer Electronics AB will accept no liability for any damage incurred during the installation or use of this software. Beijer Electronics AB prohibits all modification, changes, or conversion of the software.

Introduction to CloudVPN Solutions

Beijer Electronics provides multiple CloudVPN solutions for secure remote access.

Puerta de enlace CloudVPN 

Proporciona: 

• Acceso remoto
• Registro de datos
• Dashboard functionality

CloudVPN SecureEdge Pro 

Includes all features of CloudVPN Gateway, and adds:

• Compatibilidad con Docker
• GPS/GNSS support (requires hardware with 4G/LTE)

CloudVPN Agent 

The CloudVPN Agent runs as a Docker container on the device.

• Provides remote access to the local device only
• Does not support routing to other devices

Arquitectura de red 

A CloudVPN network can include a mix of:

• Hardware routers
• Software-based routers

The system supports one-to-one connections between sites.

CloudVPN Agent Distribution

The CloudVPN Agent is distributed as a Beijer APP (.bapp file). Select the correct version based on the device architecture:

• ARM64
  Use CloudVPN vx.xx ARM64.bapp
  (for X3 Web and other ARM64 devices)
• ARMHF
  Use CloudVPN vx.xx ARMHF.bapp
  (for GL998x Programmable I/O and other ARMHF devices)

Download the BAPP files de la Beijer Electronics Smartstore.

BAPP Support
You can install and run multiple BAPPs on the same device at the same time.

ExampConfiguración de la red de archivos

En estos examples in this quick start guide:

• LAN A is connected to the internet using DHCP
• LAN B uses a static IP address: 192.168.10.111

Install CloudVPN Agent on an X3 Web Dispositivo

You can install the CloudVPN Agent on X3 Pro Web, X3 Marine Web, and X3 Extreme Web devices. To transfer the installation file to the device, use a USB storage device.

1. Copy the CloudVPN BAPP file to the root directory of the USB storage device. Example file nombre:
   CloudVPN vx.xx ARM64.bapp
2. Power up the X3 web HMI panel.
3. Press and hold the top of the screen until Settings appears, then tap Settings.
4. Log in as Administrator.
5. Enter the password, then tap Login.
   Contraseña predeterminada: 88282282
6. Abra la pestaña Configuración.
7. Scroll down and enable the following services:
   • Silbido
   • SSH
   • Estibador
8. Pulse Guardar.
   NOTA: Remember to disable Ping after commissioning is complete.
9. Open the Apps tab.
10. Insert the USB storage device into the HMI panel.
11. Tap Add apps in the upper-right corner.
12. When the CloudVPN app appears in the list of available apps, tap Install.
    NOTA
    An Internet connection is required to complete the installation.
13. Verify that CloudVPN appears in the list of installed apps.

The CloudVPN Agent is now installed on the X3 Web HMI panel. The next step is to activate the CloudVPN Agent.

Activate the CloudVPN Agent on an X3 Web Dispositivo

After you install the CloudVPN Agent, you must activate it before use.

Antes de comenzar:
Make sure SSH is enabled in X3 Web:
Settings > General > SSH

1. Open Command Prompt or PowerShell on your PC.
2. Connect to the device using SSH:
   ssh root@<device_ip>
   Exampen:
   ssh raíz@192.168.10.111
3. Enter the root password.
   The default password is printed on the label on the back of the device. Default password: BeijerLT4C
4. List running Docker containers:
   consola de juegos docker
5. Locate the CloudVPN container and note the Container ID.
6. You must also locate the Company ID:
   a. Log in to the CloudVPN Cloud.
   b. Open the application menu (top-right corner).
   c. Select Admin.
   d. In the Company section, select Identidad.Alternativamente: Haga clic en el profile icon in the top-right corner and copy the displayed Company ID.
7. To register the agent, run the following command:
   docker exec <Container ID> /usr/bin/ixagent-register.sh<Cloud Company ID>
   Exampen:
   docker exec 92cce0ffd150 /usr/bin/ixagent-register.sh 6693-0340-0000-0000-0000NOTA
   If the message “Failed to register the Agent” appears:
   • Verify that the device has an active internet connection.
   • Make sure the agent is not already registered to another company.

The CloudVPN Agent is registered to your company.
After registration, activate the CloudVPN Agent in the CloudVPN platform.

Activate the CloudVPN Agent in the Cloud Platform

This chapter describes how to activate the CloudVPN Agent in the Cloud Platform.

1. Open the CloudVPN Cloud Platform and log in to your Beijer account.
2. Select Fleet Manager.
   If 1 new device appears, the installation on the X3 web is complete and the device has internet access.
3. Select 1 new device.
4. Select the checkbox to activate the device.
5. Enter the required device information.
6. Click Activate device.
7. Enter the CloudVPN Agent Activation Key (PN: 602-0017).
8. Hacer clic Confirmar.NOTA
   The license is valid only for the hardware where it is installed.
   If you perform a factory reset of the X3 web, the license is removed. You must then purchase a new license.
9. Haga clic en Continuar.
10. Configure the LAN settings:
    a. Go to Fleet Manager > Network > LAN.
    b. Enter the LAN IP address of the X3 web (por ejemploample, 192.168.10.200).
    c. Enter the subnet mask (for example, 255.255.255.0).
    d. Click Confirm changes.

The CloudVPN Agent is now installed and activated.

Ahora puedes:

• Connect to the device remotely
• Use available CloudVPN functions

NOTA 

CloudVPN Agent does not support routing.

You can access only the device where the agent is installed.

The next step is to start the VPN connection to access the X3 web de forma remota.

Remote Access to X3 Web and BAPP Applications

This section describes how to access the X3 web and installed BAPP applications using CloudVPN.

Connect to X3 Web Using CloudVPN 

1. In the Cloud Platform, select the device in Fleet Manager.
2. Click Connect to establish a secure VPN connection to the CloudVPN Agent.When the connection is established, the VPN status indicates that the device is connected.
3. Locate the VPN IP address in the Cloud Platform under the device connection details.
4. Access the X3 web, with Command Prompt or Powershell, using the VPN address.
   Use the following format:
   <username>@<VPN address> Exampen:
   raíz@10.187.157.62

Conectarse a WebIQ Using CloudVPN 

WebIQ Runtime is a BAPP that allows you to run a WebIQ project on the X3 web.

1. Descargar WebIQ Runtime BAPP from Tienda inteligente de electrónica de Beijing.
2. Copy the BAPP file a una unidad USB.
3. Install the BAPP on the X3 web. For installation instructions, see the X3 web Configuración y funcionamiento manual.
4. Para acceder a la WebIQ application (requires that the CloudVPN Agent is connected):
   una. Abre un web navegador.
   b. Enter the application URL using the following format:
   <IP address>:10123/<project name>
   Exampen:
   10.187.157.62:10123/main/

Ahora puedes:

• Access the X3 web de forma remota.
• Run and access WebIQ applications over a secure VPN connection.

Additional Information and Guidelines

CloudVPN agent license

The CloudVPN Agent license is locked to the hardware for the entire lifetime of the device.

If you uninstall the CloudVPN Agent or reset the hardware:

• The license is consumed.
• You must purchase a new license to continue using the service.

Resolve SSH Fingerprint Warning

When connecting to X3 Web using SSH, a fingerprint warning may appear.

This occurs when the device fingerprint has changed or does not match the stored value.

1. Locate the SSH known hosts file (.ssh).
2. Delete the entry that corresponds to the device IP address.
3. Run the SSH command again.
   Exampen:
   ssh raíz@192.168.10.111
4. When prompted, type yes and press Enter.
5. Ingrese la contraseña y presione Enter.

Restart Docker Container 

This section describes how to restart a Docker container on the X3 device.

1. Connect to the device using SSH:
   Exampen:
   ssh raíz@192.168.10.111
   Presione Enter.
2. Introduzca la contraseña.
   Default root password: BeijerLT4C
3. List running containers; enter: docker ps
4. Identify the Container ID.
5. Restart the container:
   docker container restart <CONTAINER ID>
   Exampen:
   docker container restart d475b2721155 The system restarts the selected container.

Remove Unused Data 

1. Open the Command Prompt.
2. Connect to the device using SSH: ssh root@<IP address>
3. Run the following command: docker system prune
4. When prompted, enter y and press Enter to confirm.
   The system removes unused data and displays the reclaimed disk space.

Data removed:
The command removes the following:

• all stopped containers
• all networks not used by at least one container
• all images without at least one container associated to them
• all build cache

NOTA 

Prune is also available in the settings menu on the X3 web.

How to Take a Screenshot 

This section describes how to take a screenshot from the X3 web using SSH.

1. Open the Command Prompt.
2. Start Powershell: Powershell
   Presione Enter.
3. Connect to X3 Web using SSH:
   ssh root@<IP-address>
   Presione Enter.
4. Ingrese la contraseña y presione Enter.
5. Take a screenshot:
   kmsgrab /<folder>/<file name> Exampen:
   kmsgrab /tmp/test1
6. Cerrar sesión:
   cerrar sesión
7. The screenshot is stored on the X3 web. Use SCP or an FTP client (for exampel, FileZilla) to copy the file a tu computadora.
   To use the Command Prompt, enter:
   scp root@<IP address>:/<folder>/<file name>.png .
   Exampen:
   scp root@192.168.10.111:/tmp/test1.png .
   The space followed by a dot ( .) copies the file to the current folder.

The screenshot is saved to your local computer.

NOTA 

• Screenshots are saved in PNG format only.
• The system stores screenshots in RAM.
• All screenshots are deleted when the device restarts.
• The maximum available storage for screenshots is 50 MB.
• If the screen saver is active, the screenshot is completely black.

Firmare Update of X3 web

• A firmware update preserves:
  • Docker containers
  • Ajustes
  • Licencias
• A factory reset deletes:
  • Docker containers
  • Ajustes
  • Licencias

Deleted data cannot be recovered.

Oficina central
Beijer Electronics AB
Apartado Postal 426
201 24 Malmö, Suecia
www.beijerelectronics.com / +46 40 358600