Add Device - how to connect -> Connect using Docker - select operating system
Connect using Docker - select operating system
Summary
This page allows you to select the operating system you are using for your Docker installation. This is the first step in connecting your device to the AwaBerry platform, ensuring that the necessary installation files are prepared correctly based on your chosen operating system.
Connect using Docker - Debian
This page is your guide to setting up your awaBerry device using Docker on a Debian-based system. It provides direct download links for the essential Docker configuration file and the corresponding license. Additionally, you'll find easy-to-copy commands to help you build and run your awaBerry Docker image, and manage your device.
Connect using Docker - Mint
This page is your guide to getting started with awaBerry on your Docker environment. Here, you can easily download the essential Docker setup file and the associated license for your chosen system. You will also find clear, step-by-step instructions and commands to build and run the awaBerry Docker image. Our goal is to make the connection process straightforward and secure, enabling your new awaBerry device to connect automatically once the Docker setup is complete.
Connect using Docker - Ubuntu
This page is your guide to getting your awaBerry device connected using Docker on an Ubuntu system. It provides easy access to download essential Docker files and licenses, along with clear, step-by-step commands to set up the awaBerry Docker image. Follow these instructions to ensure a smooth and successful connection of your device.
Page Access
You can access this page by navigating to: /connect_steps_docker
Page Functionalities
Operating System Selection
Users choose their operating system by tapping on dedicated tiles for Ubuntu, Debian, or Linux Mint. Tapping a tile automatically selects it and initiates the connection process.
- Ubuntu (Version: 24.04 LTS): Select this option if you are using Ubuntu.
- Debian (Version: Bookworm): Select this option if you are using Debian.
- Linux Mint (Version: 22): Select this option if you are using Linux Mint.
Information and Guidance
The page provides clear text to guide you through the selection process.
Error Messages
If an issue occurs during the connection setup, an error message will be displayed at the top of the page, informing you about the problem.
Loading Indicator
During background operations, a full-screen loading indicator will appear to show that the system is processing your request.
Scenario Executions
Possible usage steps within this page
Successful Selection and Proceed:
- Start: You are on the "Connect using Docker - select operating system" page.
- Step 1: Read the prompt: "Please select the operating system in use:".
- Step 2: Tap on the "Ubuntu" tile (or Debian, or Linux Mint).
- Expected Result: The selected tile highlights. A full-screen loading indicator appears briefly. After successful processing, the page automatically advances to the next step in the Docker connection process.
Possible errors which may occur on this page
Error Creating Docker File (Backend Issue):
- When it happens: After you select an operating system, the system tries to prepare necessary Docker files and group information on the AwaBerry backend. If there's a problem communicating with the backend services or an issue in setting up the required data for your user, this error can occur.
- What you see: A red error box appears at the top of the page with the message: "Error creating docker file - try again later."
- Why it happens: This usually indicates a temporary problem with the AwaBerry server or your internet connection preventing the system from preparing the Docker setup.
- How to resolve:
- Check your internet connection.
- Try selecting the operating system again after a few moments.
- If the issue persists, contact support.
