Features Pricing Downloads Documentation Integrations Tutorials Contact
Login Register
Back to Home

Download Cloudlinker

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

No Prerequisites Required

The installer includes a bundled Java Runtime Environment (JRE). No additional software is needed.

Windows

Windows 10/11

cloudlinker-setup.exe v1.2
Download for Windows

Quick Install

  1. 1. Run cloudlinker-setup.exe
  2. 2. Follow the installation wizard
  3. 3. Configure config.properties
  4. 4. Launch from Desktop or Start Menu

Linux / macOS

Ubuntu, Debian, Fedora, macOS

cloudlinker-linux.tar.gz v1.2
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: Run the Installer

Download and run cloudlinker-setup.exe. The installation wizard will guide you through the process.

Choose your installation directory (default: C:\Cloudlinker)
Optionally create a Desktop shortcut
Optionally start Cloudlinker at Windows startup

The installer includes a bundled Java Runtime — no additional software is needed.

Step 2: Configure

Edit the configuration file at:

C:\Cloudlinker\config.properties

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

Step 3: Start Cloudlinker

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

Cloudlinker will automatically check for updates periodically.

Uninstalling

Open Settings → Apps & Features, find Cloudlinker, and click Uninstall.

Your config.properties will be preserved in the installation folder.

Linux / macOS Installation

Step 1: Extract and Install

tar -xzf cloudlinker-linux.tar.gz
cd cloudlinker-linux
chmod +x install.sh
sudo ./install.sh

This installs Cloudlinker to /opt/cloudlinker with a bundled Java Runtime. No additional software is needed.

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)

Step 2: Configure

Edit the configuration file:

sudo nano /opt/cloudlinker/config.properties

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

Step 3: Start Cloudlinker

Choose the method that fits your environment:

Desktop / GUI

/opt/cloudlinker/cloudlinker.sh

# or via symlink
cloudlinker

Systemd Service

# Start
systemctl --user start cloudlinker

# Status
systemctl --user status cloudlinker

# Logs
journalctl --user -u cloudlinker -f

Requires --service flag during installation.

Supervisor

# Start
sudo supervisorctl start cloudlinker

# Status
sudo supervisorctl status

# Logs
tail -f /opt/cloudlinker/supervisord.log

See Supervisor setup below.

Supervisor Setup (recommended for servers)

For headless servers, Supervisor provides automatic process management with restart on failure and log rotation.

1. Install Supervisor

# Ubuntu/Debian
sudo apt install supervisor

# Fedora/RHEL
sudo dnf install supervisor

2. Create configuration

Add the following to /etc/supervisor/conf.d/cloudlinker.conf:

[program:cloudlinker]
command=/opt/cloudlinker/cloudlinker.sh
directory=/opt/cloudlinker
autostart=true
autorestart=true
user=your_username
numprocs=1
redirect_stderr=true
stdout_logfile=/opt/cloudlinker/supervisord.log
stdout_logfile_maxbytes=50MB
stdout_logfile_backups=3

Replace your_username with the Linux user that should run the application.

3. Start the service

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start cloudlinker:cloudlinker_00

Useful commands

sudo supervisorctl status - View process status
sudo supervisorctl restart cloudlinker:cloudlinker_00 - Restart the client
sudo supervisorctl stop cloudlinker:cloudlinker_00 - Stop the client
tail -f /opt/cloudlinker/supervisord.log - Follow live logs

Uninstalling

# If using supervisor, stop first
sudo supervisorctl stop cloudlinker:cloudlinker_00

# Run uninstaller
chmod +x uninstall.sh
sudo ./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 / JRE issues

The installer includes a bundled JRE. If the application doesn't start, verify the jre directory exists in the installation folder.

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