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.exe | GUI application — launches the graphical interface for interactive use. |
AppProfileSafe.CLI.exe | Command-line interface for automation, scheduled tasks, SCCM, Intune, and scripted deployments. See CLI Reference. |
settings.xml | Main 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.xmlfrom 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.jsonfile in the License folder (default:%ProgramData%\IT-Consulting Kinner\AppProfileSafe\License) - Ensure the public key file
AppProfileSafe.pemis 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
- Folder & File Structure Overview — Understand where data is stored
- Configuration: settings.xml — Customize paths and settings
- What Is an Application Definition? — Create your first app definition
- How to Create a Backup (GUI) — Run your first export