Back to Home

Download Cloudlinker

Download and install the Cloudlinker client software on your systems to enable remote device management and job execution.

Prerequisite

Java 21 or higher is required to run Cloudlinker

java -version

Windows

Windows 10/11

cloudlinker-windows.zip ~23 MB
Download for Windows

Quick Install

  1. 1. Extract the ZIP file
  2. 2. Run install.bat
  3. 3. Configure config.properties
  4. 4. Launch from Desktop or Start Menu

Linux / macOS

Ubuntu, Debian, Fedora, macOS

cloudlinker-linux.tar.gz ~23 MB
Download for Linux/macOS

Quick Install

  1. 1. Extract: tar -xzf cloudlinker-linux.tar.gz
  2. 2. Run sudo ./install.sh
  3. 3. Configure config.properties
  4. 4. Run cloudlinker

Windows Installation

Step 1: Extract the Package

Extract cloudlinker-windows.zip to a temporary location.

Step 2: Run the Installer

Open Command Prompt and navigate to the extracted folder, then run:

install.bat

Installation Options

--startup - Add Cloudlinker to Windows Startup (auto-start on boot)
--dir "C:\Path" - Install to a custom directory (default: C:\Cloudlinker)

Examples

# Standard installation
install.bat
# Install with auto-start on boot
install.bat --startup
# Install to custom directory with auto-start
install.bat --dir "D:\Programs\Cloudlinker" --startup

Step 3: Configure

Edit the configuration file at:

C:\Cloudlinker\config.properties

Fill in your organization_id and api_key (obtained from your Cloudlinker dashboard).

Step 4: Start Cloudlinker

  • Use the Desktop or Start Menu shortcut, or
  • Run C:\Cloudlinker\cloudlinker.bat

Uninstalling

Run uninstall.bat from the original installer package.

Your configuration will be backed up to %USERPROFILE%\cloudlinker-config-backup.properties

Linux / macOS Installation

Step 1: Install Java (if not installed)

Ubuntu/Debian

sudo apt update
sudo apt install openjdk-21-jre

Fedora

sudo dnf install java-21-openjdk

Arch Linux

sudo pacman -S jdk21-openjdk

macOS (Homebrew)

brew install openjdk@21

Step 2: Extract the Package

tar -xzf cloudlinker-linux.tar.gz
cd cloudlinker-linux

Step 3: Run the Installer

chmod +x install.sh
sudo ./install.sh

Note: Installation to /opt/cloudlinker requires root privileges.

Installation Options

--autostart - Add to desktop autostart (for GUI sessions)
--service - Create systemd user service (for headless/server use)
--dir /path - Install to a custom directory (default: /opt/cloudlinker)

Examples

# Standard installation
sudo ./install.sh
# Install with desktop autostart (GUI)
sudo ./install.sh --autostart
# Install as systemd service (headless server)
sudo ./install.sh --service
# Install to user directory (no sudo required)
./install.sh --dir ~/.local/share/cloudlinker

Step 4: Configure

Edit the configuration file at:

/opt/cloudlinker/config.properties

Fill in your organization_id and api_key.

Step 5: Start Cloudlinker

Desktop/GUI

cloudlinker
# or use the application menu

Systemd Service

# Start
systemctl --user start cloudlinker

# Status
systemctl --user status cloudlinker

# Logs
journalctl --user -u cloudlinker -f

Uninstalling

chmod +x uninstall.sh
./uninstall.sh

Your configuration will be backed up to ~/cloudlinker-config-backup.properties

Configuration Reference

The config.properties file contains the following settings:

Property Required Description
organization_id Yes Your organization ID from the Cloudlinker dashboard
api_key Yes Your API key from the Cloudlinker dashboard
client_id No Unique client identifier (auto-generated if empty)
api_url No API endpoint (default: https://cloudlinker.eu/api/)
server_name No MQTT server hostname (default: cloudlinker.eu)
server_port No MQTT server port (default: 4000)

Example Configuration

organization_id=your-org-id-here
api_key=your-api-key-here
client_id=
api_url=https://cloudlinker.eu/api/
server_name=cloudlinker.eu
server_port=4000

Troubleshooting

Java not found

Ensure Java is installed and in your PATH:

java -version

Connection issues

  • 1. Check your firewall allows outbound connections to cloudlinker.eu on port 4000
  • 2. Verify your organization_id and api_key are correct
  • 3. Check the application logs for detailed error messages

Windows: Application doesn't start

  • Check if Java is installed: java -version
  • Try running from command line to see errors: java -jar cloudlinker-1.0.jar

Linux: Service won't start

# Check service status
systemctl --user status cloudlinker

# View detailed logs
journalctl --user -u cloudlinker --no-pager -n 50

Need Help?

Having trouble with the installation? Our support team is here to help you get Cloudlinker up and running.

Contact Support View API Documentation