Installation & First Launch

AppProfileSafe is distributed as a portable ZIP archive. No installer or Windows service is required — extract the files and run the application.


1. Download

Download the latest version of AppProfileSafe from your customer portal or the link provided in your license email.


2. Extract

Extract the ZIP archive to your desired installation location, for example:

C:\Program Files\IT-Consulting Kinner\AppProfileSafe

The installation folder contains the following key files:

File / Folder Purpose
AppProfileSafe.exeGUI application — launches the graphical interface for interactive use.
AppProfileSafe.CLI.exeCommand-line interface for automation, scheduled tasks, SCCM, Intune, and scripted deployments. See CLI Reference.
settings.xmlMain configuration file — defines all data folder paths, logging, and retention settings. See Configuration: settings.xml.
Schema\XSD schema files for XML validation
Config\Event pipeline configuration templates (eventpipeline.xml, siem.xml, webhook.xml, redaction.xml)
Key\Public key file (AppProfileSafe.pem) for license signature verification


3. First Launch

Run AppProfileSafe.exe as administrator to start the application. On first launch, AppProfileSafe automatically:

  • Reads and validates settings.xml from the installation folder
  • Creates the data folder structure under %ProgramData%\IT-Consulting Kinner\AppProfileSafe (AppDefinitions, Schema, Mappings, Audit, Log, License, Key)
  • Verifies the audit log integrity
  • Tests the SIEM connection (if configured and active)
  • Opens the Dashboard

Important: AppProfileSafe requires administrator privileges. The application will show an error and exit if not running elevated. Right-click AppProfileSafe.exe and select Run as administrator, or launch from an elevated command prompt.


4. CLI Mode

AppProfileSafe ships two executables: AppProfileSafe.exe for the GUI and AppProfileSafe.CLI.exe for command-line automation. The CLI is a native console application with proper support for output redirection, pipes, and scheduled tasks.

AppProfileSafe.CLI.exe --export --manifestFile "C:\Backup\Manifest.xml" --apps "Firefox,Chrome"

See CLI Command Overview for details.


5. Add License

Without a valid license, AppProfileSafe runs in test mode with limited functionality (restricted number of selectable applications). On startup, the License Info dialog is shown automatically when no license is found or the license has issues.

To activate full functionality:

  • Place your License.json file in the License folder (default: %ProgramData%\IT-Consulting Kinner\AppProfileSafe\License)
  • Ensure the public key file AppProfileSafe.pem is present in the Key folder
  • Restart the application

See How Licensing Works and Installing or Updating a License for details.


6. Verify Installation

After launching AppProfileSafe, check the Dashboard status tiles to verify your installation:

Status Tile Expected State
License Green (valid license) or Red with "Test Mode" (no license installed yet)
Audit Green with "0 entries" and "Integrity OK" on first launch
Pipeline Gray with "Not configured" (expected unless you have set up event pipeline sinks)
Health Green (all checks pass)
Support Green with "Online" (support portal reachable) or Red with "Unreachable" (no internet)


Next Steps