Debian-based offline installation

Installation when isolated from the internet

Some customers don't let servers access the internet and receive SVC-Runner-based applications as single zip file that contains all the required Debian packages and sometimes helper scripts.

Directory for *.deb

To install these packages first create a directory to extract the deb files in.

TIP

We recommend to always keep the installation files for the current and previous generation to allow for a rollback to the previous version if an update turns out to have unexpected problems.

The following example creates a date-named directory under /install/svc-runner/

mkdir -pv /install/svc-runner/$(date +%Y-%m-%d)
cd /install/svc-runner/$(date +%Y-%m-%d)

WARNING

In fresh installations of Debian 13 or above the directories /tmp and /var/tmp are regularly cleaned so /var/tmp is no suitable place for installation files any more.

Extract the zip file

Next extract the deb files in the directory created above.

The following example obviously assumes the zip to has been put in /tmp/ under an example filename, please adjust the path and file name to whatever you chose to name the zip file.

unzip /tmp/20251110_infex.zip

Optionaly install requirements

When installing svc-runner for the first time we recommend to satisfy eventual requirements before installing the svc-runner itself.

INFO

ITEG's zip files often contain a script named install_prerequisites.sh that performs the according apt call, assuming the system has access to some apt repository providing the packages for the Debian-based distribution in use.

Install *.deb

Simply install the deb files:

sudo dpkg -i *.deb

Eventually satisfy unmet dependencies

If dpkg has complained about unmet dependencies then the following command usually resolves those:

sudo apt -f install

Configuration

When installing svc-runner for the first time then configuration work is required, i.e. editing and eventually creating files in subdirectories of /etc/svc-runner/.

For basic configuration information see SVC-Runner Configuration Basics.

For application specific configuration details please look at the application documentation.