Installation - Manual

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.)

• x64 – 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.pkg – the installation package

• defaults.command – a configuration file for the settings

3. Verify the installation package signature

To ensure that the file has not been tampered with during transmission, the digital signature should be verified before distribution or installation.

4. Installing the Application

Install the application using the provided macOS installer package (.pkg).

1. Open the extracted folder.

2. Start the installation by double-clicking IBI-aws Client.pkg.

3. If macOS prompts for it, enter the username and password of an administrator.

4. After the installation has completed successfully, a confirmation message is displayed.

The application is automatically installed in the /Applications folder.

5. Configuration of Application Settings

In order for the IBI-aws Client for macOS to be able to display messages, it must be defined where the relevant information can be obtained from.

The file defaults.command allows these settings to be configured.

Specifying the data source (Remarks) is mandatory.

6. First Launch of the Client

When starting the IBI-aws Client for macOS 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.

7. Autostart

In order for the messages to be displayed, the IBI-aws client for macOS must be started automatically when the user logs in. This can be achieved, for example, by using Login Items.

8. Optional: Encrypted Messages

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

/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.

9. Log Files

The client’s log files are located at:

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

The user Library folder is hidden by default in macOS.
To make it visible, choose View → Show View Options and enable Show Library Folder.

The logs are helpful for support cases or troubleshooting.