> ## Documentation Index > Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg. > People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files. > Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it. # Benutzerdefinierte Sandboxes > Erstellen Sie aus einem Dockerfile eine Sandbox mit den Sprachen und Tools, die Ihr Team benötigt, und starten Sie darauf Research-Sessions. Research führt Befehle in der Standard-Sandbox von Enclave aus. Wenn Ihr Team andere Sprachen, Tools oder eine andere Linux-Distribution benötigt, kann ein Owner oder Admin aus einem Dockerfile eine **benutzerdefinierte Sandbox** erstellen. Danach kann jeder in der Organisation eine Session darauf starten. ## Bevor Sie beginnen * Zum Erstellen, Neuerstellen und Löschen einer Sandbox benötigen Sie die Berechtigung, Integrationen zu verwalten: die Rolle **Owner** oder **Admin**. Siehe [Rollen und Berechtigungen](https://docs.enclave.ai/de/admin/roles.md). * Benutzerdefinierte Sandboxes sind bei [Bring-your-own-Cloud](https://docs.enclave.ai/de/deployment/byoc.md)-Deployments nicht verfügbar. ## Sandbox erstellen **1. Research fragen** Beschreiben Sie in einer [Research-Session](https://docs.enclave.ai/de/research/sessions.md), was Sie benötigen, und geben Sie der Sandbox einen Namen. Zum Beispiel: "I need a sandbox where the agent can run jq and protoc. Call it tools." **2. Dockerfile genehmigen** Research schreibt ein Dockerfile und zeigt eine Karte **Create the sandbox tools?** mit dem Base-Image und dem Dockerfile an. Prüfen Sie es und klicken Sie auf **Approve**. **3. Build verfolgen** Eine Build-Karte zeigt den Status (**Queued**, **Building**, **Testing**, **Ready**, **Build failed** oder **Cancelled**), die verstrichene Zeit und das Build-Log. Klicken Sie auf **Cancel**, um den Build abzubrechen. Wenn der Build fertig ist, erhält die Session das Ergebnis, und Research teilt Ihnen die nächsten Schritte mit. Wenn der Build fehlschlägt, erklärt Research den Grund und kann ein korrigiertes Dockerfile vorschlagen. Außerdem erhalten Sie eine Benachrichtigung, sodass Sie es auf jeder Seite erfahren. Eine Sandbox wird nur gespeichert, wenn ihr Build erfolgreich ist. Ein fehlgeschlagener oder abgebrochener Build ändert nichts an dem, was Mitglieder sehen. Um eine Sandbox zu ändern, bitten Sie Research, sie unter ihrem Namen zu aktualisieren. Research zeigt dann eine Karte **Update the sandbox** an. Die aktuelle Version bleibt in Verwendung, bis der neue Build erfolgreich ist. ### Regeln für Dockerfiles * Das Dockerfile basiert auf `enclave/base`, dem Standard-Sandbox-Image von Enclave, sofern Sie kein anderes Betriebssystem benötigen. Andere Base-Images müssen aus einer öffentlichen Registry stammen. * Es gibt keinen Build-Kontext. `COPY` und `ADD` können keine lokalen Dateien lesen, aber `ADD` kann eine `http(s)`-URL herunterladen oder ein Git-Repository klonen. * Ein Dockerfile darf bis zu 64 KB groß sein und bis zu 100 Anweisungen enthalten. * Ein Build kann bis zu 30 Minuten laufen. ## Session auf einer Sandbox starten Klicken Sie in einer neuen Session im Eingabefeld auf die Sandbox-Auswahl und wählen Sie unter **Sandbox environment** eine Sandbox aus. **Enclave default** ist die eigene Sandbox von Enclave. Eine Session behält ihre Sandbox. Um eine andere zu verwenden, starten Sie eine neue Session. Eine Sandbox, die gerade neu erstellt wird, zeigt in der Auswahl **Rebuilding** an. Neue Sessions verwenden ihren letzten erfolgreichen Build, bis der neue erfolgreich ist. ## Sandboxes verwalten Unter **Settings → Sandboxes** sehen Sie die Sandboxes Ihrer Organisation, ihren Status (**Ready** oder **Rebuilding**) und wann der verwendete Build erstellt wurde. Owner und Admins klicken auf **Manage**, um das aktuelle Dockerfile und das Log des letzten Builds zu sehen und um: * Die Sandbox mit **Rebuild** aus ihrem Dockerfile neu zu erstellen. * Einen laufenden Build mit **Cancel** abzubrechen. * Die Sandbox mit **Delete** zu löschen. Sessions, die sie verwenden, können ihre Sandbox nicht erneut starten und fordern Sie auf, eine neue Session zu starten. Wenn Enclave seine Sandbox-Software aktualisiert, wird eine benutzerdefinierte Sandbox automatisch neu erstellt, sobald jemand das nächste Mal eine Session darauf startet. Bis dahin verwenden Sessions den letzten erfolgreichen Build. ## Limits * 3 Sandboxes pro Organisation. Eine neue Sandbox, deren erster Build läuft, zählt zum Limit. * 20 Builds pro Organisation innerhalb von 24 Stunden. Neuerstellungen, die Enclave nach einem Update startet, zählen nicht. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.