This is the documentation of an pre-release opsi version. The documentation for the current version 4.3 can be found here.

Welcome to opsi!

The client management system opsi (Open System Integration) manages Windows, Linux and macOS clients—​from a dozen to several thousand computers. The core component is a Linux server which takes care of automatic installation of operating systems (Windows and Linux only), distribution of software, hardware and software inventory, and patch management on the clients. In addition, there are modules to extend opsi’s capabilities. In summary, opsi has the following features:

  • Automatically distribute software on PCs with the opsi client agent.

  • Automatically install operating systems using the opsi server.

  • Perform comprehensive hardware and software inventory.

opsi offers a single administration interface to manage all clients in multiple locations. The configuration is stored in a central place: on the opsi server. The depot servers for the clients (installation files of the software, operating systems to be distributed, boot images, etc.) can also be located in several places.

This manual has the following structure:

For comprehensive technical details, please refer to our specialized API manuals: python-opsi and python-opsi-common.

Engage with the opsi community at the opsi forum, where you can also access the link to our opsi wiki.

Conventions and Notations

In this manual, we adhere to specific conventions for spelling and emphasis:

  • File and directory names are presented in proportional font.

  • Longer commands and listings are contained in separate boxes. These can be conveniently transferred using copy & paste:

this is a command

  • opsi-script code is displayed like this:

Message "Installing "+ $ProductId$ +" ..."

  • Elements in <angle brackets> indicate placeholders that you need to replace with their actual values. For instance, the file share containing opsi packages is referred to as <opsi-depot-share>. On an actual server, this is typically found at /var/lib/opsi/depot. Hence, the software package <opsi-depot-share>/ooffice would be located at /var/lib/opsi/depot/ooffice.

  • Menu entries and button labels are formatted in italics.

  • Keyboard keys and combinations are enclosed in square brackets, for example, [C], [Ctrl]+[C], etc.