Contact Uscybus.io

Installing Connectware (Docker)

Prerequisites

  • You have a valid license key.

  • You have an Internet connection to download Docker images from registry.cybus.io.

  • Docker and Docker Compose are installed and running on your host.

    • For more information on installing Docker, refer to the Docker documentation. Docker Desktop includes Docker Compose along with Docker Engine and Docker CLI which are Compose prerequisites.

  • You are familiar with Docker. For more information on using Docker, see our Docker Basics Lesson.

Preparing the Installer Script

The installer script allows you to quickly install Connectware.

  1. Download the installer script for the Connectware version that you want to install.

$ wget -O ./connectware-online-installer.sh https://download.cybus.io/latest/connectware-online-installer.sh

  1. Optional: It is a security risk to run bash scripts downloaded directly from the web. So feel free to open the installer script and check its contents.

$ cat connectware-online-installer.sh

  1. Make the script executable so it can be run as a script.

You can now run the installer script to install Connectware.

Running the Installer Script

You can run the installer script without administrator rights in most cases. However, sudo privileges are required in two scenarios:

  1. When setting up Connectware as a systemd service (recommended)

  2. When installing to a directory that needs elevated permissions

Since this guide demonstrates installing Connectware with systemd service integration, we'll use sudo in the following commands.

  1. Run the installer script.

  1. The version of Connectware will be printed with a greeting. To confirm that the version is correct, press enter.

  2. You will now be asked for your desired target directory for installation. In this example we will press enter to go with the default path: /opt/connectware

  3. The installer script will then run preflight checks to make sure that all system requirements are met. If they are not then please check the prerequisites section at the beginning of this lesson.

If all requirements are met then you should see the following output.

  1. You will now be prompted for your Cybus license key. If your credentials are valid then you should see the following output.

  1. You will now be asked whether you would like to boot Connectware as a system-service. Without this, the application must be started by hand every time the host system starts. In this example we will press enter to confirm yes.

  2. The installer script will then print your chosen options and ask for confirmation that they are correct. If you followed this example then you should see the following.

  1. The Connectware container images will then pulled onto your system. After they are successfully pulled, the installer script will check for old container images of previous Connectware versions, which can safely be removed („pruned“) to clean up disk space. The installer will ask for confirmation before any container images are removed. In this example the question looks as follows.

  1. After confirming your choice, you can observe the result of the image removal operation. As the last step, the installer will print a message telling you Connectware has been started or which commands you need to enter to run or stop Connectware. In our example you should be prompted with the following.

Running the Installation in Silent Mode

The installer supports an automated deployment mode that requires no manual intervention. You can activate this by using either -s or --silent when running the installation script.

For silent installations, you must provide your license key through the --license-key parameter. By default, this method installs a basic version of Connectware to /opt/connectware and skips the systemd service setup.

If you need to customize your installation, the script offers several configuration options. Run the installer with --help to view all available parameters.

Updating SSL Certificates

When you need to update your SSL certificates (such as after a Let's Encrypt renewal via certbot or when adding self-signed certificates), follow these steps:

  1. Copy the new certificates:

  1. The name of your Connectware container depends on the directory it was installed to and is rendered as <your-connectware-directory>_connectware_1. By default, Connectware is installed to /opt/connectware/ which results in the container name connectware_connectware_1.

  2. Restart the Connectware proxy to apply the changed files. Replace your-connectware-container with your actual Connectware container name based on your installation directory.

PreviousInstalling Connectware (Kubernetes)NextUpgrading Connectware

Last updated

Was this helpful?