System Requirements

Important

The Sol3 SDK is generally distribution agnostic, but is only officially supported for Ubuntu Linux (18.04+) hosts. Compatibility with other distros may be achieved if the following system requirements can be met with similar distribution-specific commands.

The Sol3 SDK requires the following software to be installed on your development machine:

Optional Requirements

Installing Docker

# Update package index
sudo apt-get update

# Install Docker Engine
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Add your user to the docker group
sudo usermod -aG docker $USER

# Log out and log back in, or run:
newgrp docker

# Verify installation
docker --version

Installing Devcontainer CLI

Install via npm

# Install nodejs (if needed)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install devcontainer-cli globally via npm
npm install -g @devcontainers/cli

# Verify installation
devcontainer --version

Alternative: Install via GitHub Releases

# Linux x64
curl -L https://github.com/devcontainers/cli/releases/latest/download/devcontainer-cli-linux-x64.tar.gz | tar -xz
sudo mv devcontainer /usr/local/bin/

# Verify installation
devcontainer --version

Installing adb (Android Debug Bridge)

Android Debug Bridge is required to discover the HDK IP address when connected via USB. This enables the Sol3 SDK to establish SSH connections to the HDK for deployment and debugging.

Install via apt (Ubuntu/Debian)

# Install adb
sudo apt-get update
sudo apt-get install -y adb

# Verify installation
adb --version

# Check for connected devices
adb devices

Installing Visual Studio Code (Optional)

Visual Studio Code provides devcontainer integration for the Sol3 SDK.

# Method 1: Download from Microsoft
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt update
sudo apt install code

# Method 2: Snap package
sudo snap install --classic code

# Verify installation
code --version

Using VS Code with Sol3 SDK

# Open project in VS Code
code .

# VS Code will automatically detect the devcontainer configuration
# and prompt to "Reopen in Container"