Connect using Docker - select operating system -> Connect using Docker - Mint

Connect using Docker - Mint

Summary

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.

Page Access

You can access this page by navigating to: /connect_steps_docker?os=mint

Page Functionalities

Download Docker File Button

This button allows you to download the specific Docker setup file tailored for your chosen operating system and Docker version. Clicking it will either start a download or open the file in a new browser tab for review.

Download License Link

Beneath the Docker File button, you'll find a link to download the necessary license file for your awaBerry Docker setup. Clicking this will also initiate a download or open the license in a new browser tab.

Docker Commands with Copy Option

Several essential Docker commands are displayed on this page: the 'Docker Build Command', 'Docker Run Command', and 'Docker Exec Command'. Each command comes with a convenient copy icon next to it. Clicking this icon will instantly copy the command to your clipboard, allowing you to paste it directly into your terminal without manual typing.

Instructional Text

Guidance text is provided to help you understand where to store the downloaded Docker file and the sequence of steps to execute the Docker commands to start the awaBerry Docker image. It also explains that new devices will be added automatically once the setup is complete.

Back to device list Button

Located at the bottom of the page, this button allows you to navigate back to the list of your devices, concluding the Docker connection setup for this session.

Scenario Executions

Possible usage steps within this page

Here are common ways you might use this page to successfully set up your awaBerry Docker connection:

  1. Downloading and Setting Up Your Docker Environment:
    • Click the "Download Docker File" button to get the setup file for your system.
    • Click the "Download license" link to secure your license.
    • Follow the instructions on the page to store the downloaded Dockerfile.
    • Copy the "Docker Build Command" by clicking its copy icon and paste it into your Docker terminal to prepare your awaBerry image.
    • Copy the "Docker Run Command" and execute it to start the awaBerry container.
    • Copy the "Docker Exec Command" to access the running container if needed.
    • Once these steps are completed, click the "Back to device list" button to return to your device overview, where your new awaBerry device should appear automatically.
  2. Only Copying Commands:
    • If you have already downloaded the files but need the commands again, simply click the copy icon next to each command you require (Build, Run, Exec).
    • Paste them into your terminal and proceed with your Docker operations.
    • Click "Back to device list" when you are done.

Possible errors which may occur on this page

While this page is designed to be straightforward, here are some issues you might encounter and why they happen:

  1. Download Failed:

    If clicking the "Download Docker File" button or "Download license" link does not start a download or open a new browser tab, it could be due to:

    • No Internet Connection: Your device might not be connected to the internet, preventing access to the download servers.
    • Browser Restrictions: Some browser security settings might block automatic downloads or pop-ups. You may need to adjust your browser settings or allow the download manually.
    • Temporary Server Issue: Rarely, there might be a temporary problem with the server hosting the files. Trying again after a short while usually resolves this.
  2. Command Not Copied:

    When you click the copy icon next to a Docker command, you should see a confirmation message. If this message doesn't appear and the command isn't in your clipboard:

    • Browser Security: Some web browsers have strict security policies regarding copying content to the clipboard from web pages. This is usually a rare occurrence but can happen.
    • Temporary Glitch: A minor, temporary issue with your device or browser could prevent the copy action. A quick refresh of the page or trying again often fixes this.

Up to User Manual Main Page