2. Installing eCAL

Before using eCAL, you must install it on your PC. This section covers how to install eCAL on Microsoft Windows and Ubuntu (both 64 bit only). You can either use eCAL just on one PC (local communication) or on multiple PCs (cloud communication). We will cover both scenarios in the next sections.

So, let’s get started!

See also

If you are looking for a tutorial on how to build eCAL from source (e.g. to get it working on a non-supported OS) please refer to Building eCAL from source .

2.1. |fa-windows| Installing eCAL on Windows

  1. Choose your desired eCAL Version from the eCAL Download Archive and download the Windows installer. New users should download the latest Version.

  2. Install eCAL with default options (Full installation):

    eCAL Setup

2.2. |fa-ubuntu| Installing eCAL on Ubuntu

For Ubuntu, you can either install eCAL from a PPA (Personal Package Archive) or manually from debian files. For most users, the PPA will provide the easiest way of installing eCAL. The PPA also supports more Ubuntu Versions and CPU Architectures (x86, x64, arm64, armhf).

Ubuntu 22.04 Users: You may experience issues with the GUI Applications (actually all Qt5 Apps) due to Ubuntus switch to wayland. But you can log in with X11, which solves those issues.

See also

Advanced users can also compile eCAL from source.

2.2.1. |fa-ubuntu| Automatically install eCAL from a PPA

Installing eCAL from a PPA will cause apt-get to automatically update eCAL for you. You can choose from different PPAs, depending on your desired upgrade path.

2.2.2. |fa-ubuntu| Manually install eCAL from a .deb file

Warning

We usually recommend installing from a PPA (see above).

  1. Choose your desired eCAL Version from the eCAL Download Archive.

  2. Install the eCAL Dependencies:

    • Ubuntu 18.04:

      sudo apt update
      sudo apt install libc6 libcurl4 libgcc1 libhdf5-100 libprotobuf10 libqt5core5a libqt5gui5 libqt5widgets5 libqt5svg5 libstdc++6 sysstat ifstat libqwt-qt5-6 libyaml-cpp0.5v5
      
    • Ubuntu 20.04:

      sudo apt update
      sudo apt install libc6 libcurl4 libgcc-s1 libhdf5-103 libprotobuf17 libqt5core5a libqt5gui5 libqt5widgets5 libqt5svg5 libstdc++6 sysstat ifstat libqwt-qt5-6 libyaml-cpp0.6
      
    • Ubuntu 22.04:

      sudo apt update
      sudo apt install libc6 libcurl4 libgcc-s1 libhdf5-103 libprotobuf23 libqt5core5a libqt5gui5 libqt5widgets5 libqt5svg5 libstdc++6 sysstat ifstat libqwt-qt5-6 libyaml-cpp0.7
      
  3. Install the debian package:

    sudo dpkg -i ecal_*.deb