Install the Server Agent via Portal

If you aim to use our latest features such as ‘Run Command’, ‘Server Update Management Service’ and many more in the future, the STACKIT Server Agent must be installed on your server as a basis. It serves as an interface between our infrastructure and the operating system and receives and processes scripts sent remotely and executes them locally on your server, allowing you to configure your server as required.

The following documentation describes two ways to get your server fully configured with the latest STACKIT Server Agent version available. You can either set up a new server in the STACKIT Portal that automatically deploys the STACKIT Server Agent on first boot, or if you already have a running Linux or Windows server, you can manually execute a script which downloads and installs the STACKIT Server Agent.

If you prefer to configure your system and manage the Run Command feature via API, please refer to this documentation: Install the Server Agent via API.

Installing the STACKIT Server Agent via STACKIT Portal during server deployment

1. Check with the table if your operating system supports an automated first boot installation of the STACKIT Server Agent via STACKIT Portal.

Image	Installation via API	Installation via STACKIT Portal
Windows Server 2016	✅	✅
Windows Server 2019	✅	✅
Windows Server 2022	✅	✅
Windows Server 2025	✅	✅
RHEL	✅	✅
CentOS	✅	✅
Ubuntu	✅	✅
Fedora	✅	✅
Rocky Linux	✅	✅
AlmaLinux	✅	✅
Debian	✅	✅ (Not yet supported in Debian 11)

If it does not, use the API: Install the Server Agent via API
Alternatively you can install the agent manually once the server is set up and running, see below. 2. During the server deployment, go to the server creation tab, open the drop down menu Provision STACKIT Server Agent and select Yes 3. Finish the server ordering procedure.

The STACKIT Server Agent will then be installed during the initial first boot configuration. Once the server completes its deployment configuration routines, it is ready-to-use and can be used to run commands.

Example of the STACKIT Server Agent on a Windows Server 2022:

Installing the STACKIT Server Agent on an existing server (Linux)

Important: In order to install the STACKIT Server Agent you will need an Administrative (superuser) privileges!

1. Logon to your server remotely. Use a method that includes a clipboard functionality, e. g. Remote Desktop Connection.
2. Open a shell.
3. Optional: Verify the signature
   You can verify the GPG signature of the STACKIT Server Agent package with the following scripts:
   • Linux, RPM-based (Fedora, RedHat)
     Source file: RPM (Fedora/RedHat based)

#!/bin/bash

#Download GPG public key
curl https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.gpg -o /tmp/stackit-server-agent.gpg
### Install dependencies

yum install gnupg -y

### Import GPG Public key
gpg --import /tmp/stackit-server-agent.gpg

### Download STACKIT Server Agent
curl http://169.254.169.254/stackit/v1/server-agent/amd64/rpm -o /tmp/stackit-server-agent.rpm

### Download the package signature file
curl https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.rpm.sig -o /tmp/stackit-server-agent.rpm.sig

if gpg --verify /tmp/stackit-server-agent.rpm.sig /tmp/stackit-server-agent.rpm
then
 echo "The STACKIT Server Agent is verified successfully"
else
 echo "The STACKIT Server Agent is not verified successfully"
 rm -rf /tmp/stackit-server-agent.gpg /tmp/stackit-server-agent.rpm.sig /tmp/stackit-server-agent.rpm
 exit 1
fi

rm -rf /tmp/stackit-server-agent.gpg /tmp/stackit-server-agent.rpm.sig

• Linux, DEB-based (Debian, Ubuntu)
  Source file: DEB (Debian based)

#!/bin/bash

#Download GPG public key
curl https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.gpg -o /tmp/stackit-server-agent.gpg

### Install dependencies

apt-get update && apt-get install gnupg -y

### Import GPG Public key
gpg --import /tmp/stackit-server-agent.gpg

### Download STACKIT Server Agent
curl http://169.254.169.254/stackit/v1/server-agent/amd64/deb -o /tmp/stackit-server-agent.deb

### Download the package signature file
curl https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.deb.sig -o /tmp/stackit-server-agent.deb.sig

if gpg --verify /tmp/stackit-server-agent.deb.sig /tmp/stackit-server-agent.deb
then
 echo "The STACKIT Server Agent is verified successfully"
else
 echo "The STACKIT Server Agent is not verified successfully"
 rm -rf /tmp/stackit-server-agent.deb /tmp/stackit-server-agent.deb.sig /tmp/stackit-server-agent.gpg
 exit 1
fi

rm -rf /tmp/stackit-server-agent.gpg /tmp/stackit-server-agent.deb.sig

Once the package is successfully verified you can install it by running:
Source file: RPM (Fedora/RedHat based)

yum localinstall /tmp/stackit-server-agent.rpm -y

or
Source file: DEB (Debian based)

dpkg -i /tmp/stackit-server-agent.deb

4. Download and install the STACKIT Server Agent (without GPG verification)
   Copy and paste the script into the shell and execute it:
   • Linux, RPM-based (Fedora, RedHat)
     Source file: RPM (Fedora/RedHat based)

#!/bin/bash

### Download STACKIT Server Agent
curl http://169.254.169.254/stackit/v1/server-agent/amd64/rpm -o /tmp/stackit-server-agent.rpm

### Install the Agent
yum localinstall /tmp/stackit-server-agent.rpm -y

### Cleaning up
rm -rf /tmp/stackit-server-agent.rpm

• Linux, DEB-based (Debian, Ubuntu)
  Source file: DEB (Debian based)

#!/bin/bash

### Download STACKIT Server Agent
curl http://169.254.169.254/stackit/v1/server-agent/amd64/deb -o /tmp/stackit-server-agent.deb

### Install the Agent
dpkg -i /tmp/stackit-server-agent.deb

### Cleaning up
rm -rf /tmp/stackit-server-agent.deb

5. If the installation was successful, check if the service is running:

systemctl status stackit-server-agent.service

The STACKIT Server Agent is now fully configured and can accept commands remotely and execute them locally on your system.

Installing the STACKIT Server Agent on an existing server (Windows)

1. Logon to your server remotely. Use a method that includes a clipboard functionality, e. g. Remote Desktop Connection.
2. Start PowerShell ISE with elevated permissions.
3. Copy and paste the script into the shell and execute the script.
   Source file: MSI

## Download STACKIT Server Agent
New-Item -ItemType Directory -Path "C:\ProgramData\STACKIT\ServerAgent" -Force
Invoke-WebRequest -Uri "http://169.254.169.254/stackit/v1/server-agent/amd64/msi" -OutFile "C:\ProgramData\STACKIT\ServerAgent\STACKITServerAgent.msi"

### Install the Agent
Start-Process -FilePath "C:\Windows\System32\msiexec.exe" -ArgumentList "/i C:\ProgramData\STACKIT\ServerAgent\STACKITServerAgent.msi /quiet /l*v C:\Windows\Temp\STACKITServerAgent_install.log" -NoNewWindow -Wait

4. After successful installation, check if the service is running. Open the PowerShell and run the following command:

Get-Service STACKITServerAgent

Alternatively check the status in the the Service tab of the task manager:

The STACKIT Server Agent is now fully configured and can be used to execute commands.