Zum Inhalt springen

Erste Schritte

Erste Schritte

Füg einen Link ein oder beschreib, was du brauchst. Setup schreibt ein Rezept, startet einen Test und betreibt die App auf Wunsch dauerhaft.

Auf dieser Seite
  1. Was du einfügen kannst
  2. Schritt für Schritt
  3. 1. Einfügen
  4. 2. Setup liest es und schreibt ein Rezept
  5. 3. Einen Test starten
  6. 4. Behalten
  7. Wo du deine Apps findest
  8. Grenzen, die du kennen solltest
  9. Wie es weitergeht

Setup macht aus einem Link oder einem Satz laufende Software. Du fügst ein GitHub-Repository, einen Hugging Face Space oder eine Installationsanleitung ein, oder du schreibst, was du brauchst, zum Beispiel „eine Fotosicherung für meine Familie“. Setup findet heraus, wie das läuft, startet es in einer Sandbox und gibt dir einen Link zum Öffnen.

Jede neue App startet als kostenloser Test, der sich nach 60 Minuten selbst entfernt. Gefällt sie dir, behältst du sie, und Setup kümmert sich ab dann um sie. Du installierst nichts, und auf deinem eigenen Computer läuft nichts.

Was du einfügen kannst

Du fügst einBeispielWas Setup macht
Ein Git-Repositoryhttps://github.com/louislam/uptime-kumaLiest die setup.json, die Compose-Datei, das Dockerfile oder den üblichen Aufbau der Programmiersprache
Einen Link auf eine Dateihttps://github.com/owner/app/blob/main/compose.yaml, eine Raw-URL, ein GistLiest diese Datei, zusammen mit dem Repository drumherum, wenn es eins gibt
Eine Docker-Compose-DateiDen Inhalt einer compose.yaml, mit ihrer .env, falls es eine gibtMacht aus ihren Diensten ein Rezept
docker run-Befehledocker run -d -p 8080:80 traefik/whoami:v1.10Macht aus einem oder mehreren Befehlen eine App
Ein Imagenginx:1.27, ghcr.io/owner/app:1.2 oder eine Docker-Hub-SeiteLiest die Ports und Volumes, die das Image angibt, aus seiner Registry, ohne es herunterzuladen
Ein DockerfileEin Dockerfile, das keine eigenen Dateien kopiertBaut es. Eines, das Dateien kopiert, braucht das Repository, in dem es liegt
Eine App-Store-DefinitionEine CasaOS-, Umbrel-, Runtipi- oder Cosmos-App oder eine Portainer-VorlageMacht ein Rezept daraus und öffnet den Port, den der Store öffnen würde
Kubernetes-ManifesteEin Deployment mit Service, Volume Claim, ConfigMap und SecretMacht aus den Teilen, die für eine App Sinn ergeben, ein Rezept und nennt den Rest
Einen Hugging Face Spacehttps://huggingface.co/spaces/owner/nameLiest, wie der Space eingerichtet ist
Eine Doku-SeiteEine Anleitung mit einem docker run- oder Compose-SchnipselMacht aus dem Schnipsel ein Rezept und schlägt verlinkte Repositorys vor
Einen Satz„ein Wiki für mein Team“Schlägt passende Software vor
Ein RezeptDen Inhalt einer setup.jsonNimmt es, wie es ist

GitLab und andere Git-Hoster funktionieren auch. owner/name allein meint ein GitHub-Repository; gibt es keins, liest Setup das gleichnamige Image auf Docker Hub. Die Ausnahme sind Links zu Sprachmodellen auf Hugging Face: Setup betreibt Apps, keine Sprachmodelle. Was du stattdessen tun kannst, steht in den häufigen Fragen.

Du kannst eine Chat-Antwort oder einen Ausschnitt aus einer README so einfügen, wie sie ist. Setup holt die Code-Blöcke aus dem Text drumherum und liest eine Compose-Datei und ihre .env zusammen. Eingefügter Text darf bis zu 100.000 Zeichen lang sein.

Alles, was du einfügst, liest Setup nur als Daten. Was ein Rezept nicht sicher ausführen kann (privilegierter Modus, Ordner des Hosts, der Docker-Socket, Host-Netzwerk, zusätzliche Capabilities), lässt Setup weg und nennt jedes davon unter Was Setup aufgefallen ist. Beim Lesen lädt es kein Image herunter und führt nichts aus.

Im Eingabefeld startet Eingabe eine einzelne Zeile. Hat der Text mehrere Zeilen, fügt Eingabe wie in jedem Editor eine Zeile hinzu, und ⌘ Eingabe (Strg Eingabe unter Windows und Linux) startet. Das Feld zeigt beim Tippen, was es erkannt hat, und nach der Analyse sagt die Seite, was Setup gefunden hat, zum Beispiel „Eine Datei für Docker Compose mit 3 Diensten“.

Schritt für Schritt

1. Einfügen

Melde dich an und öffne dein Dashboard unter /dashboard. In der Detailansicht fügst du den Link in das Feld unter „Was soll laufen?“ ein und klickst auf Starten. In der einfachen Ansicht sagst du dem Assistenten, was du brauchst, oder du öffnest App hinzufügen und wählst eine App danach aus, wofür du sie brauchst.

Du kannst auch im öffentlichen Katalog unter /catalog anfangen (Starten auf der Seite eines Projekts) oder mit einem „Run on Setup“-Button in der README eines Projekts.

2. Setup liest es und schreibt ein Rezept

Setup lädt, was du eingefügt hast, und liest es wie ein Dokument. Dabei wird nichts installiert und nichts ausgeführt. Die Schritte der Analyse kannst du live verfolgen.

Das Ergebnis ist ein Rezept: eine kurze Datei namens setup.json. Sie sagt, welche Programme laufen, welche Einstellungen sie brauchen und wie Setup prüft, ob die App funktioniert. Unter Was läuft steht das Rezept in einfachen Worten, unter Rezept-JSON als Datei, falls du es bearbeiten willst. Treffsicherheit zeigt, wie sicher sich Setup ist, und Was Setup aufgefallen ist nennt, was du vor dem Start prüfen solltest.

Eine setup.json im Repository hat Vorrang, danach ein kuratiertes Rezept aus dem Setup-Katalog, danach das, was Setup selbst erkennt. Findet Setup nichts, was es betreiben kann, sagt es dir das und schlägt etwas anderes vor. Mehr dazu unter Rezepte.

3. Einen Test starten

Füll die Einstellungen aus, die die App braucht. Passwörter und geheime Schlüssel mit dem Hinweis „Wird erzeugt, wenn du es leer lässt“ kannst du leer lassen, Setup erzeugt sie selbst. Wähl unter Wie lange die Option Ausprobieren und klick auf Starten.

Ein Runner übernimmt die App und startet sie in einer Sandbox. Die Seite zeigt jede Phase: Warten auf einen Runner, Vorbereiten der Sandbox, Laden der Images oder Bauen, Starten der Dienste und Prüfen. Mit einem fertigen Image dauert das oft ein, zwei Minuten. Bauen aus dem Quellcode dauert länger. Sobald die Prüfungen bestanden sind, bekommst du die Adresse der App.

Apps laufen auf dem eigenen Runner deines Workspaces, wenn einer online ist, sonst auf Setup Cloud. Ist gerade kein Runner verfügbar, wartet die App in der Warteschlange, bis sich einer verbindet. Wie du einen eigenen Rechner anschließt, steht unter Runner.

4. Behalten

Ein Test läuft 60 Minuten. Zehn Minuten vor dem Ende bekommst du eine E-Mail. Ist die Zeit um, entfernt Setup die App mit allem, was darin gespeichert ist.

Um die App zu behalten, klickst du vor dem Ende des Tests auf ihrer Seite auf Behalten. Eine behaltene App läuft, bis du sie entfernst. Setup prüft, ob sie antwortet, schreibt dir, wenn sie ausfällt, und du kannst automatische Updates und regelmäßige Sicherungen einschalten. Alles dazu steht unter Dauerhaft betreiben.

Weißt du schon vorher, dass du eine App behalten willst, wähl vor dem Start Dauerhaft betreiben statt Ausprobieren.

Wo du deine Apps findest

In der Detailansicht zeigt Apps unter /dashboard/apps alles im Workspace, mit den Tabs Aktiv, Tests, Fehler und Beendet. Öffne eine App, um ihre Adresse, Logs, ihren Zustand, die Sicherungen, das Rezept und die Einstellungen zu sehen.

In der einfachen Ansicht zeigt Deine Apps auf der Startseite jede App als Karte, mit einem Status in einfachen Worten wie „Läuft“ oder „Problem“ und der restlichen Testzeit. Öffnen öffnet die App selbst, Nachfragen gibt die Frage an den Assistenten weiter.

Team-Workspaces haben dieselben Seiten unter ihrer eigenen Adresse, zum Beispiel /dashboard/dein-team/apps.

Grenzen, die du kennen solltest

  • Ein Test dauert 60 Minuten und lässt sich nicht verlängern. Behalte die App stattdessen.
  • Du kannst 30 Analysen pro Stunde starten. Eingefügter Text darf bis zu 100.000 Zeichen lang sein.
  • Setup betreibt keine Sprachmodelle. Apps, die eines nutzen, bekommen Adresse und Schlüssel einer gehosteten Modell-API wie OpenRouter als Einstellung.
  • Wenn du eine App entfernst, sind sie und ihre Daten weg. Das lässt sich nicht rückgängig machen.

Wie es weitergeht