The AI-Native Device Platform
User Manual

Connect via browser or VNC client

This page displays instructions for connecting to a remote VNC server, offering both browser-based and dedicated VNC client options, alongside daily VNC usage statistics.

Connect via browser or VNC client

Summary

This page provides comprehensive instructions for connecting to your remote device via VNC. You can choose between a simple browser-based connection, which requires no software installation, or a more powerful connection using a dedicated VNC client. The page also shows your daily VNC usage, helping you keep track of your active session time against your allotted maximum minutes. You can initiate a stop for your active VNC server from this page.

Page Access

You can access this page by navigating to: /devices_rdp

Page Functionalities

  • VNC Server Status and Control: A prominent area displays whether your VNC server is active. You can click on this area to stop the VNC server.
  • VNC Usage Statistics: A section shows your daily VNC usage in minutes, displaying both the time spent and your maximum allowed minutes. This data is refreshed automatically every minute.
  • Connect via Browser: This section provides a straightforward way to connect without needing to install any software.
    • Open Browser Connection Button: Click this button to open a new browser window or tab that connects directly to your remote desktop using a web-based VNC viewer.
    • Share Button: An icon allows you to share the browser connection instructions via email or messenger.
  • Connect via VNC Client: This section guides you through connecting using a dedicated VNC client application.
    • Operating System Selection: Choose between "Mac / Linux" or "Windows" to get tailored instructions for your system.
    • Step 1: Download Client: Download a small installation script specific to your chosen operating system.
    • Step 2: Run Installation: Instructions and commands are provided to run the downloaded script in your Terminal (Mac/Linux) or Command Prompt (Windows). This script sets up the necessary bridge for your VNC client.
    • Step 3: Configure VNC Client: Provides the local connection address (e.g., 127.0.0.1:port_number) that you will use in your preferred VNC client application (like macOS's built-in Screen Sharing or a third-party client).
    • Share Button: An icon allows you to share the VNC client connection instructions, including download links and connection details, via email or messenger.
  • Important Info Box: This box provides crucial information regarding idle connections, explaining that they are dropped after ten minutes of inactivity or after 30 minutes without a client connection. It also details how idle time is booked against your daily usage contingent.

Scenario Executions

Possible usage steps within this page:

Connecting via your web browser:

  1. Ensure your VNC server is active (indicated by the green status box).
  2. Locate the "Connect via Browser" section.
  3. Click the "Open Browser Connection" button.
  4. A new browser tab or window will open, connecting you to your remote desktop.

Stopping the VNC server:

  1. Locate the green status box at the top of the page.
  2. Click anywhere on this status box.
  3. The status will change to "Stopping VNC server..." and then update when stopped.

Connecting via a dedicated VNC client (Mac / Linux):

  1. Ensure your VNC server is active.
  2. Locate the "Connect via VNC Client" section.
  3. Select "Mac / Linux" under "Select your operating system".
  4. Under "Step 1: Download Client", click the "Download File" button to get the installation script.
  5. Under "Step 2: Run Installation", open your Terminal application.
  6. Navigate to your downloads folder using the cd command.
  7. Execute the two provided commands: chmod +x your_script_name.sh and ./your_script_name.sh (replace your_script_name.sh with the actual downloaded filename).
  8. Under "Step 3: Configure VNC Client", note the "Connection Address" (e.g., 127.0.0.1:port_number).
  9. Open your VNC client (e.g., macOS Screen Sharing or another VNC client) and enter the noted connection address.

Connecting via a dedicated VNC client (Windows):

  1. Ensure your VNC server is active.
  2. Locate the "Connect via VNC Client" section.
  3. Select "Windows" under "Select your operating system".
  4. Under "Step 1: Download Client", click the "Download File" button to get the installation script.
  5. Under "Step 2: Run Installation", open your Command Prompt application.
  6. Navigate to your downloads folder using the cd command.
  7. Execute the provided command: your_script_name.bat (replace your_script_name.bat with the actual downloaded filename).
  8. Under "Step 3: Configure VNC Client", note the "Connection Address" (e.g., 127.0.0.1:port_number).
  9. Open your preferred VNC client application and enter the noted connection address.

Sharing browser connection instructions:

  1. Locate the "Connect via Browser" section.
  2. Click the share icon (a circle with an arrow pointing upwards).
  3. In the pop-up dialog, click "Copy to Clipboard".
  4. You can now paste the instructions into an email or messenger.

Sharing VNC client connection instructions:

  1. Locate the "Connect via VNC Client" section.
  2. Click the share icon (a circle with an arrow pointing upwards).
  3. In the pop-up dialog, click "Copy to Clipboard".
  4. You can now paste the instructions into an email or messenger.

Possible errors which may occur on this page:

VNC Server Not Active: If the VNC server status box is not green or indicates a problem, you will not be able to connect. This usually means the remote device is offline, the VNC server process failed to start, or there's a network issue on the remote end.
Browser Connection Blocked: When clicking "Open Browser Connection", your browser might block the new window or tab as a pop-up. You will need to allow pop-ups for app.awaberry.com in your browser settings.
Download Failures: If the "Download File" button for the VNC client script does not work, check your internet connection and browser download settings.
Script Execution Errors: When running the installation script in Terminal or Command Prompt, errors might occur if the file was not downloaded correctly, you don't have the necessary permissions to execute the script, or required system components are missing.
VNC Client Connection Issues: If your VNC client cannot connect to 127.0.0.1:port_number, ensure the installation script ran successfully, that no other application is using that local port, and that your VNC client is configured correctly.
Exceeding VNC Time Limit: The "VNC time spent today" section will show if you are nearing or have exceeded your max minutes. If you exceed the limit, new VNC sessions may be prevented or existing ones disconnected.
Idle Connection Drop: The info box states "Idle connections are dropped after ten minutes of inactivity or after 30 minutes without a client connection." This means your remote session might unexpectedly close if there's no activity or no client connected for extended periods.
Navigate ← awaBerry Anywhere: Remote Desktop Access ← Device Main Page ← Devices Overview Details ← Devices Overview ← awaBerry Device Management ← awaBerry User Manual Main Page