> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/realmjoin-agent/realmjoin-client/native-choco-runtime.md).

# Native Choco Runtime

Die Native Choco Runtime ist die eigene paketinterne Installations-Engine von RealmJoin, die die veraltete Binärdatei Chocolatey 0.10.3 ersetzt und dabei vollständig mit bestehenden Paketen kompatibel bleibt.

{% hint style="info" %}
Die Native Choco Runtime wurde mit **RealmJoin Agent 4.21.6 (Beta)**. Die Funktion ist **optional**: bestehende Clients verwenden weiterhin die klassische Chocolatey-Engine, bis Sie die native Runtime ausdrücklich aktivieren.
{% endhint %}

## Was es ist

Wenn der RealmJoin Agent Softwarepakete außerhalb von Intune installiert (siehe [Paketinstallation](https://docs.realmjoin.com/de/realmjoin-agent/realmjoin-client/deploy-apps.md#package-installation)), hat er traditionell auf [Chocolatey](https://chocolatey.org/) als zugrunde liegende Paket-Engine verlassen. RealmJoin hat einen fest vorgegebenen, stark gepatchten Build der Open-Source-Chocolatey-CLI ausgeliefert — Version **0.10.3** — gebündelt als `choco.exe` unter `C:\ProgramData\chocolatey\`.

Die **Native Choco Runtime** ersetzt diese mitgelieferte Chocolatey-Binärdatei durch RealmJoins **eigene, speziell entwickelte Implementierung** die **im Prozess** im RealmJoin-Dienst ausgeführt wird. Sie *fungiert als Shim für* Chocolatey: Sie versteht dasselbe Paketformat (`.nupkg`) und verhält sich aus Sicht von Paketautoren und Administratoren genauso, ist jedoch nicht länger von der veralteten Chocolatey-0.10.3-Codebasis abhängig.

Mit anderen Worten: Die Pakete, die Sie bereits verwenden, funktionieren unverändert weiter — nur die Engine darunter ändert sich.

## So funktioniert es

* **Engine im Prozess.** Paketinstallationen laufen innerhalb des RealmJoin-Dienstes, statt einen externen `choco.exe`. Die `chocolateyInstall.ps1` jedes Pakets wird in einem im Prozess laufenden PowerShell-Runspace ausgeführt.
* **Isolierter Speicher.** Die native Runtime installiert sich in ihr **eigenes** Stammverzeichnis, `C:\ProgramData\RealmJoin\choco\` (mit `lib\`, `extensions\`, und `logs\` Unterordnern). Sie schreibt niemals in den Zustand von klassischem Chocolatey unter `C:\ProgramData\chocolatey\` und ändert niemals die systemweite `ChocolateyInstall` Umgebungsvariable. Das bedeutet, dass die native Runtime und ein bereits vorhandenes klassisches Chocolatey **nebeneinander existieren** auf demselben Gerät.
* **Automatische Auflösung von Abhängigkeiten.** Paketabhängigkeiten, die in der `.nuspec` (zum Beispiel die [RealmJoin Core Choco Extension](https://docs.realmjoin.com/de/realmjoin-agent/recommended-packages.md#realmjoin-core-choco-extension)) werden automatisch aus Ihren konfigurierten Quellen aufgelöst und installiert.
* **`choco.exe` Shim.** Einige Paketskripte rufen `choco.exe` direkt auf. Damit diese weiterhin funktionieren, stellt die Runtime einen kleinen Shim unter `%ProgramFiles%\RealmJoin\choco-shim\choco.exe` bereit, der solche Aufrufe zurück in die im Prozess laufende Engine statt in klassisches Chocolatey umleitet. Der Shim wird nicht zum systemweiten `PATH`; er ist nur für Paketskripte verfügbar, während sie ausgeführt werden.

## Kompatibilität

Die Native Choco Runtime ist als **direkter Ersatz**:

* Bestehende RealmJoin-Pakete (einschließlich allem aus der [Package Store](https://docs.realmjoin.com/de/anwendungsverwaltung/packages/package-store.md)) installieren und deinstallieren sich auf die gleiche Weise.
* Im RealmJoin Portal konfigurierte Paketargumente / Parameter funktionieren weiterhin.
* Die [RealmJoin Core Choco Extension](https://docs.realmjoin.com/de/realmjoin-agent/recommended-packages.md#realmjoin-core-choco-extension) Hilfs-Cmdlets, die in Paketskripten verwendet werden, bleiben verfügbar.
* [RealmJoin ESP](https://docs.realmjoin.com/de/realmjoin-agent/realmjoin-client/realmjoin-esp.md) / Autopilot werden unterstützt: Auf einem frischen Gerät mit aktivierter nativer Runtime, `winchoco` werden Pakete während der Registrierung nativ installiert, wobei ihre Abhängigkeiten automatisch aufgelöst werden.

{% hint style="warning" %}
Da diese Runtime in Beta ist, empfehlen wir, Ihre wichtigsten Pakete zunächst in einem Pilot-Ring zu validieren, bevor Sie sie tenantweit ausrollen. Bitte melden Sie Abweichungen im Verhalten dem RealmJoin-Support, damit wir sie vor der allgemeinen Verfügbarkeit beheben können.
{% endhint %}

## Wie man sie verwendet

Die Runtime wird über eine RealmJoin **Einstellung**, sodass Sie sie zentral steuern können, statt einzelne Clients anzufassen. RealmJoin-Einstellungen vererben sich kaskadierend, was bedeutet, dass Sie eine **tenantweite Standardvorgabe** und bei Bedarf **für bestimmte Gruppen außer Kraft setzen** (und die Objekte darin).

{% hint style="info" %}
Einstellungsschlüssel: `Chocolatey.UseNativeRuntime`

Einstellungswert: `wahr` / `falsch`
{% endhint %}

Die folgenden Einstellungen steuern das Verhalten:

<table><thead><tr><th>Einstellung</th><th width="120">Standard</th><th>Bedeutung</th></tr></thead><tbody><tr><td><code>Chocolatey.Enabled</code></td><td><code>falsch</code></td><td>RealmJoin verwaltet auf dem Gerät Pakete des Typs Chocolatey.</td></tr><tr><td><code>Chocolatey.UseNativeRuntime</code></td><td><code>falsch</code></td><td>Hauptschalter. Wenn <code>falsch</code>, werden Installationen weiterhin über die klassische <code>choco.exe</code>. Wenn <code>wahr</code>, alle <code>winchoco</code> Installationen laufen über die im Prozess laufende native Runtime.</td></tr><tr><td><code>Chocolatey.DisableShim</code></td><td><code>falsch</code></td><td>Nur relevant, wenn <code>UseNativeRuntime = true</code>. Wenn <code>wahr</code>, löst jedes Paketskript, das einen externen <code>choco.exe</code> aufruft, lautstark einen Fehler aus, statt über den Shim umgeleitet zu werden — nützlich, um Skripte sichtbar zu machen, die noch nach einer externen Binärdatei greifen.</td></tr></tbody></table>

{% stepper %}
{% step %}

### Aktivieren Sie es zunächst für eine Pilotgruppe

Öffnen Sie die Einstellungen einer RealmJoin **Gruppe** die eine kleine Menge von Pilotgeräten enthält, und setzen Sie `Chocolatey.UseNativeRuntime` an `wahr` dort. Da Gruppeneinstellungen Vorrang vor der tenantweiten Standardvorgabe haben, wechseln nur diese Geräte zur neuen Engine.
{% endstep %}

{% step %}

### Validieren Sie Ihre Pakete

Lassen Sie die Pilotgeräte ihre normalen Paketzuweisungen und Upgrades ausführen. Bestätigen Sie, dass Installationen erfolgreich sind, und prüfen Sie die Protokolle, wenn etwas seltsam aussieht (siehe [Probleme bei der Paketinstallation](https://docs.realmjoin.com/de/fehlerbehebung-and-faq/troubleshooting/package-installation-issues.md)).
{% endstep %}

{% step %}

### Rollen Sie es tenantweit aus

Sobald Sie sich sicher sind, setzen Sie `Chocolatey.UseNativeRuntime` an `wahr` da die **tenantweite Standardvorgabe** so, dass alle Clients es verwenden. Einzelne Gruppen können sich weiterhin dagegen entscheiden, wenn Sie sie vorübergehend auf der klassischen Engine belassen müssen.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Die Konfiguration folgt demselben Modell aus Tenant-Einstellung / Gruppen-Override wie die anderen Agent-Einstellungen unter [Allgemeine Einstellungen](https://docs.realmjoin.com/de/administration-and-einstellungen/general.md) (zum Beispiel die **Client-Konfiguration** und **LAPS-Konfiguration** Tenant-Einstellungen).
{% endhint %}

## Was ist die Standard-

Die Native Choco Runtime ist **standardmäßig deaktiviert** (`Chocolatey.UseNativeRuntime = false`). Clients verwenden weiterhin die klassische, gebündelte Chocolatey-0.10.3-Engine, bis ein Administrator die native Runtime aktiviert — entweder tenantweit oder für eine bestimmte Gruppe. So können Sie die neue Runtime in Ihrem eigenen Tempo einführen und ebenso leicht zurückrollen, solange die Funktion in Beta ist.

## Migration vorhandener Geräte

Die native Runtime und klassisches Chocolatey **nebeneinander existieren** können auf einem Gerät so lange koexistieren, wie nötig. Wenn Sie die native Runtime auf einem Gerät aktivieren, auf dem bereits mit klassischem Chocolatey installierte Pakete vorhanden sind:

* Bestehende von RealmJoin verwaltete Pakete funktionieren weiterhin und werden **nicht** nicht neu installiert, nur weil sich die Runtime geändert hat — ihr installierter Zustand bleibt beim Wechsel erhalten, sodass es keine Neuinstallationswelle gibt.
* Neue Installationen und Upgrades laufen über die native Runtime; die klassische Installation bleibt unverändert auf der Festplatte, bis sie ausdrücklich entfernt wird.

{% hint style="info" %}
Die flächenweite Entfernung von klassischem Chocolatey ist als separater, koordinierter Schritt geplant. Bis dahin kann die native Runtime problemlos neben einer verbliebenen klassischen Installation bestehen, sodass es keine harte Frist für die Bereinigung gibt.
{% endhint %}

Für ein einzelnes Gerät (z. B. während Support oder QA) kann ein Administrator eine Maschine mit dem Verb des Shims aus einer `migrieren Sie` erhöhten **Shell:** # Vorschau, was passieren würde, ohne Änderungen vorzunehmen

{% code overflow="wrap" %}

```powershell
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --dry-run
# Installieren Sie zustandsbehaftete Pakete über die native Runtime erneut und entfernen Sie dann die klassische

& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --yes
choco migrate
```

{% endcode %}

{% hint style="warning" %}
`ist ein` Admin-Hilfswerkzeug für ein einzelnes Gerät **(Support, Entwicklung/QA, einmalige Bereinigung). Es ist** nicht der Mechanismus, um die Änderung im gesamten Gerätebestand auszurollen — verwenden Sie dafür die Tenant-/Gruppen-Einstellungen. **nicht** Protokolle & Problembehebung
{% endhint %}

## Installationen der nativen Runtime schreiben ein Protokoll pro Paket nach:

Installationen der nativen Runtime schreiben ein Protokoll pro Paket nach:

```
C:\ProgramData\RealmJoin\choco\logs\<package-id>\<timestamp>_<version>_<operation>.log
```

(es werden pro Paket nur die 10 neuesten Einträge aufbewahrt). Dies ist getrennt von klassischem Chocolateys `C:\ProgramData\chocolatey\logs\`. Wenn Sie Protokolle für eine Supportanfrage sammeln, fügen Sie den `C:\ProgramData\RealmJoin\` Ordner hinzu, wie in [Probleme bei der Paketinstallation](https://docs.realmjoin.com/de/fehlerbehebung-and-faq/troubleshooting/package-installation-issues.md).

### Datei- & Pfadreferenz

| Pfad                                              | Zweck                                                  |
| ------------------------------------------------- | ------------------------------------------------------ |
| `C:\ProgramData\RealmJoin\choco\lib\<id>`         | Installationsstammverzeichnis der nativen Runtime.     |
| `C:\ProgramData\RealmJoin\choco\extensions\<id>`  | Automatisch importierte PowerShell-Hilfsmodule.        |
| `C:\ProgramData\RealmJoin\choco\logs\<id>`        | Protokolle pro Installation (je Paket die letzten 10). |
| `C:\Program Files\RealmJoin\choco-shim\choco.exe` | Die `choco.exe` Shim.                                  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/de/realmjoin-agent/realmjoin-client/native-choco-runtime.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
