Installation – DaaS-IoT SDK for GNU/Linux¶
The DaaS-IoT SDK for Linux provides a platform-specific wrapper around libdaas, enabling developers to integrate the DaaS-IoT networking layer into Linux applications using a clean, high-level API.
This section describes the two supported installation methods:
- Installation via APT repository (recommended)
- Manual build from source via CMake
1. Install via APT Repository (Recommended)¶
This is the preferred and fastest installation method. It automatically configures your system to receive stable SDK updates published by Sebyone.
Step 1 — Import the SDK repository key¶
sudo mkdir -p /usr/share/keyrings
curl -fsSL https://daasiot.sebyone.it/apt/daassdk-repo.gpg.asc | sudo tee /usr/share/keyrings/daassdk.gpg >/dev/null
Step 2 — Add the APT repository¶
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/daassdk.gpg] https://daasiot.sebyone.it/apt stable main" | sudo tee /etc/apt/sources.list.d/daassdk.list
Step 3 — Update & Install¶
sudo apt update
sudo apt install -y libdaas-wrapper
This will install:
- the Linux wrapper (
libdaas-wrapper.so/.a) - all public headers required by developers
- the correct version of libdaas (static precompiled binary)
The library is ready to be included in your CMake or GNU Make projects immediately.
2. Build From Source (CMake)¶
This method is recommended if you require:
- local modifications to the wrapper
- integration into a custom build pipeline
- explicit validation of downloaded libdaas packages via MD5 checksum
Clone the official repository:
git clone https://github.com/sebyone/daasiot-gnu
cd daasiot-gnu
Step 1 — Obtain the MD5 Checksum¶
Download the .md5 file matching your desired libdaas version:
Example for v0.20.01:
https://daasiot.sebyone.it/releases/libdaas/v-0.20.01/linux/gcc/libdaas-0201-linux-gcc.tar.gz.md5
Copy the hash value — it will be passed to CMake for integrity verification.
Step 2 — Configure the Build¶
cmake -S . -B build -DDAAS_VERSION=0.20.01 -DDAAS_FILETAG=0201 -DDAAS_MD5=<paste_the_md5_here> -DCMAKE_BUILD_TYPE=Release
CMake Parameters
| Parameter | Description |
|---|---|
DAAS_VERSION |
The libdaas release version (e.g. 0.20.01) |
DAAS_FILETAG |
Short tag used in release filenames (e.g. 0201) |
DAAS_MD5 |
Checksum from the .md5 file to validate the download |
CMAKE_BUILD_TYPE |
Set to Release for production builds |
During configuration, CMake will automatically:
- download the correct libdaas package
- verify its integrity using MD5
- extract headers and static library
- set up include/link paths for the wrapper
Step 3 — Build the SDK¶
cmake --build build --config Release
On completion, the compiled wrapper library and related artifacts will appear in:
build/
│── lib/
│── include/
└── ...
The wrapper can now be integrated directly into your application.
Notes¶
- The Linux SDK is designed to be self-contained: no system-wide libdaas installations are needed.
- Each SDK version is tied to a specific libdaas release to ensure binary compatibility.
- When installed via APT, updates are provided only for stable SDK versions.