Linux Installation

Chloros is distributed for Linux as .deb packages that install the CLI and backend. The Python SDK is installed separately via pip.

---

Linux amd64 (x86_64)

System Requirements

Requirement	Minimum	Recommended
Distribution	Ubuntu 20.04+ / Debian 11+	Ubuntu 22.04+
Processor	x86_64 (Intel/AMD)	Intel Core i7 or better
Memory (RAM)	8GB	16GB or more
Graphics Card	None (CPU processing)	NVIDIA GPU with 4GB+ VRAM
Storage	2GB free space	SSD with 10GB+ free space
Python	Python 3.7+ (for SDK)	Python 3.10+

Installation

Download the .deb package and install:

sudo dpkg -i chloros-amd64.deb

Verify the installation:

chloros-cli --version

---

Linux arm64 (NVIDIA Jetson)

System Requirements

Requirement	Minimum	Recommended
Platform	NVIDIA Jetson with JetPack 6	Jetson Orin NX 16GB or AGX Orin
JetPack	JetPack 6.x	Latest JetPack 6
Memory (RAM)	8GB (shared GPU/CPU)	16GB+ shared
Storage	2GB free space	NVMe SSD with 10GB+ free
Python	Python 3.7+ (for SDK)	Python 3.10+

Installation

Download the JetPack 6 .deb package and install:

sudo dpkg -i chloros-arm64-jp6.deb

Verify the installation:

chloros-cli --version

For detailed Jetson setup including thermal management and field deployment, see the NVIDIA Jetson Guide.

---

Python SDK Installation (All Linux)

The Python SDK is installed separately via pip and works on both amd64 and arm64:

pip install chloros-sdk

To include optional progress streaming support:

pip install chloros-sdk[progress]

Verify the SDK:

python -c "import chloros_sdk; print(chloros_sdk.__version__)"

The .deb package installs the Chloros CLI and backend. The Python SDK is a separate pip package that communicates with the backend via a local HTTP API.

---

Configuration Directories

Chloros on Linux follows the XDG Base Directory Specification:

Purpose	Linux Path	Windows Equivalent
Configuration	~/.config/chloros/	%APPDATA%\Chloros\
Data / Projects	~/.local/share/chloros/	%LOCALAPPDATA%\Chloros\
Cache / Credentials	~/.cache/chloros/	%APPDATA%\Chloros\cache\

Backend Executable Locations

The .deb package installs the backend to a standard location. The CLI and SDK auto-detect the backend path:

Installation Method	Backend Path
.deb package	/usr/lib/chloros/chloros-backend
Manual / custom	/opt/mapir/chloros/backend/chloros-backend

You can override the backend path with the --backend-exe CLI flag or the backend_exe SDK constructor parameter.

---

First-Time Setup

1. Activate Your License

A Chloros+ license is required for CLI and SDK access:

chloros-cli login [e-mail] 'your-password'

2. Check Your License Status

chloros-cli status

3. Process Your First Dataset

chloros-cli process ~/datasets/flight001

4. Run System Diagnostics

Verify that your system is configured correctly:

chloros-cli selftest

This runs 7 diagnostic checks including version, backend startup, API connectivity, and CUDA/GPU availability.

---

Bash Scripting Examples

Process Multiple Datasets

#!/bin/bash
for dataset in ~/datasets/2026/*/; do
    echo "Processing $(basename "$dataset")..."
    chloros-cli process "$dataset" --format tiff-32
    echo "Done: $(basename "$dataset")"
done

Process with Custom Settings

#!/bin/bash
chloros-cli process ~/datasets/field_a \
    --output ~/output/field_a \
    --format tiff-32 \
    --indices NDVI NDRE GNDVI \
    --debayer texture-aware \
    --no-vignette

Automated Processing with Cron

Add to your crontab (crontab -e) to process new datasets automatically:

# Process any new datasets at 2 AM daily
0 2 * * * /usr/bin/chloros-cli process /data/incoming --output /data/processed >> /var/log/chloros.log 2>&1

Python SDK Example

from chloros_sdk import process_folder

# One-line processing
result = process_folder(
    "/home/user/datasets/flight001",
    indices=["NDVI", "NDRE"],
    export_format="TIFF (32-bit, Percent)"
)

---

Troubleshooting

CLI Not Found After Installation

If chloros-cli is not found after installing the .deb package:

# Check if the binary exists
which chloros-cli
ls -la /usr/bin/chloros-cli

# If not in PATH, check the installation
dpkg -L chloros-amd64  # or chloros-arm64-jp6

# Reload your shell
source ~/.bashrc

Permission Denied

# Ensure the binary is executable
sudo chmod +x /usr/bin/chloros-cli
sudo chmod +x /usr/lib/chloros/chloros-backend

Backend Failed to Start

# Check if port 5000 is already in use
lsof -i :5000

# Kill any existing process on port 5000
kill $(lsof -t -i :5000)

# Try starting with a different port
chloros-cli --port 5001 process ~/datasets/flight001

CUDA Not Detected

# Check NVIDIA driver installation
nvidia-smi

# Check CUDA availability
nvcc --version

# On Jetson, check JetPack version
cat /etc/nv_tegra_release

Missing Shared Libraries

# Install common dependencies
sudo apt-get update
sudo apt-get install -f

# Check for missing libraries
ldd /usr/lib/chloros/chloros-backend | grep "not found"

---

Updating Chloros on Linux

Use the built-in update command to check for and install updates:

# Check for updates without installing
chloros-cli update --check

# Check for and install updates
chloros-cli update

---

Next Steps

• NVIDIA Jetson Guide — Jetson-specific optimization and deployment

• CLI : Command Line — Full CLI command reference

• API : Python SDK — Full SDK reference

• Dynamic Compute Adaptation — How Chloros adapts to your hardware