Installation

This guide describes the complete installation process of the IBI-aws Client for macOS, including preparation, configuration, and optional steps for encrypted messages.

1. Download the Appropriate Version

The IBI-aws Client is provided as a ZIP file. There are two variants:

arm64 – for Macs with Apple Silicon (M1, M2, M3, etc.)
intel64 – for older Macs with Intel processors
Download the ZIP file and then extract it.

2. Contents of the Extracted Folder

After extraction, the IBI-aws Client folder contains:

IBI-aws Client.app – the actual application
defaults.command – a configuration file for storing the URL of the message file

3. Installing the Application

3.1. Move IBI-aws Client.app

The IBI-aws Client.app file must be moved to the system /Applications folder:

Open the IBI-aws Client folder
Drag IBI-aws Client.app into Applications

4. Configuring the Message File URL

The defaults.command file contains the URL to the centrally managed message file.

4.1. Adjust the URL

Open the defaults.command file with a text editor (e.g., TextEdit).
Replace the included URL with your own target URL.
Save the file.

4.2. Execute the Configuration

The file can be executed in two ways:

Double-click on defaults.command
Or in the Terminal:

CODE

./defaults.command

This saves the configuration using macOS defaults. This corresponds to the startup parameter Remark.

5. First Launch of the Client

When starting the IBI-aws Client for the first time, a setup assistant appears, through which all required permissions can be granted.
The client needs these permissions to display all messages correctly.

6. Optional: Encrypted Messages

If encryption of messages has been enabled in IBI-aws Admin, the following folder must also be created:

CODE

/Library/Application Support/IBITECH/IBI-aws

Important Notes

Creating this folder requires sudo privileges.
The certificate generated in the admin must be placed in exactly this folder.

7. Log Files

The client’s log files are located at:

CODE

/Users/user/Library/Logs/IBI.aws.Client

The logs are helpful for support cases or troubleshooting.